GraphHandle QML Type

A draggable handle positioned in graph data coordinates. More...

Import Statement: import QuickGraphLib.GraphItems
Inherits:

Item

Properties

Signals

Detailed Description

GraphHandle is an interaction helper for graph item editors. It renders a small handle at position and emits moved with the new data position when dragged.

Property Documentation

cursorShape : int

The mouse cursor shown while hovering the handle.


dataTransform : matrix4x4 [required]

Must be assigned the data transform of the graph area this handle is paired to.

See also GraphArea::dataTransform.


delegate : Component

Optional component used to replace the default handle visual.

The delegate is loaded inside the handle and can read the handle state through parent.handle. For example, a delegate can bind to parent.handle.role, parent.handle.selected and parent.handle.dragging.


dragging : bool

Whether the handle is currently being dragged.


fillColor : color

The normal fill color.


hitSize : real

The mouse hit target size of the handle.


hoverFillColor : color

The fill color used while hovered.


movable : bool

Whether the handle can be dragged.


position : point [required]

The handle position in data coordinates.


role : int

The semantic editing role of the handle.

This describes what the handle does. It is separate from shape, which only controls the default visual appearance.


selected : bool

Whether the handle should be drawn in the selected style.


selectedFillColor : color

The fill color used while selected or dragged.


shape : int

The rendered handle shape.


size : real

The visual size of the handle.


strokeColor : color

The outline color.


strokeWidth : real

The outline width.


Signal Documentation

clicked()

Emitted when the handle is clicked.

Note: The corresponding handler is onClicked.


moved(point position)

Emitted when the handle has moved to position in data coordinates.

Note: The corresponding handler is onMoved.