Delegate Controls#

Guidelines for delegate controls

Qt Quick Controls offers a selection of controls that are used as delegates in views.

qml-qtquick-controls-checkdelegate.html

Item delegate with a check indicator that can be toggled on or off.

qml-qtquick-controls-itemdelegate.html

Basic item delegate that can be used in various views and controls.

qml-qtquick-controls-radiodelegate.html

Exclusive item delegate with a radio indicator that can be toggled on or off.

qml-qtquick-controls-swipedelegate.html

Swipable item delegate.

qml-qtquick-controls-switchdelegate.html

Item delegate with a switch indicator that can be toggled on or off.

qml-qtquick-controls-treeviewdelegate.html

A delegate that can be assigned to a TreeView.

Each type of delegate has its own specific target use case. The following sections offer guidelines for choosing the appropriate type of delegate, depending on the use case.

CheckDelegate Control#

../_images/qtquickcontrols-checkdelegate.gif

CheckDelegate presents a checkable control that can be toggled on (checked) or off (unchecked). Check delegates are typically used to select one or more options from a set of options.

See also CheckBox Control .

ItemDelegate Control#

../_images/qtquickcontrols-itemdelegate.gif

ItemDelegate presents a checkable control that can be pressed and clicked by the user.

RadioDelegate Control#

../_images/qtquickcontrols-radiodelegate.gif

RadioDelegate presents a checkable control that can be toggled on (checked) or off (unchecked). Radio delegates are typically used to select one option from a set of options.

See also RadioButton Control .

SwipeDelegate Control#

../_images/qtquickcontrols-swipedelegate.gif

SwipeDelegate presents a view item that can be swiped left or right to expose more options or information.

SwitchDelegate Control#

../_images/qtquickcontrols-switchdelegate.gif

SwitchDelegate presents a switchable delegate that can be toggled on or off.

See also Switch Control .

TreeViewDelegate Control#

../_images/qtquickcontrols-treeviewdelegate.png

A TreeViewDelegate is a delegate that can be assigned to the delegate property of a TreeView.

See also TreeView.