1// Copyright (C) 2017 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
5 \page qtquickcontrols-delegates.html
6 \title Delegate Controls
7 \ingroup qtquickcontrols-guidelines
8 \brief Guidelines for delegate controls
10 Qt Quick Controls offers a selection of controls that are used as
13 \annotatedlist qtquickcontrols-delegates
15 Each type of delegate has its own specific target use case. The following
16 sections offer guidelines for choosing the appropriate type of delegate,
17 depending on the use case.
19 \section1 CheckDelegate Control
21 \image qtquickcontrols-checkdelegate.gif
23 \l CheckDelegate presents a checkable control that can be toggled on
24 (checked) or off (unchecked). Check delegates are typically used to
25 select one or more options from a set of options.
27 \b {See also} \l {CheckBox Control}.
29 \section1 ItemDelegate Control
31 \image qtquickcontrols-itemdelegate.gif
33 \l ItemDelegate presents a checkable control that can be pressed and
36 \section1 RadioDelegate Control
38 \image qtquickcontrols-radiodelegate.gif
40 \l RadioDelegate presents a checkable control that can be toggled on
41 (checked) or off (unchecked). Radio delegates are typically used to select
42 one option from a set of options.
44 \b {See also} \l {RadioButton Control}.
46 \section1 SwipeDelegate Control
48 \image qtquickcontrols-swipedelegate.gif
50 \l SwipeDelegate presents a view item that can be swiped left or right to
51 expose more options or information.
53 \section1 SwitchDelegate Control
55 \image qtquickcontrols-switchdelegate.gif
57 \l SwitchDelegate presents a switchable delegate that can be toggled on or off.
59 \b {See also} \l {Switch Control}.
61 \section1 TreeViewDelegate Control
63 \image qtquickcontrols-treeviewdelegate.png
65 A \l TreeViewDelegate is a delegate that can be assigned to the delegate property
68 \b {See also} \l {TreeView}.
70 \section1 Related Information
72 \li \l {Qt Quick Controls Guidelines}