aboutsummaryrefslogtreecommitdiffstats
path: root/src/quickcontrols2/doc/src/qtquickcontrols2-delegates.qdoc
blob: a5ccb95bc3b11255d6f2da20a8044069093ef0a9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
// Copyright (C) 2017 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
    \page qtquickcontrols2-delegates.html
    \title Delegate Controls
    \ingroup qtquickcontrols2-guidelines
    \brief Guidelines for delegate controls

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

    \annotatedlist qtquickcontrols2-delegates

    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.

    \section1 CheckDelegate Control

    \image qtquickcontrols2-checkdelegate.gif

    \l 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.

    \b {See also} \l {CheckBox Control}.

    \section1 ItemDelegate Control

    \image qtquickcontrols2-itemdelegate.gif

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

    \section1 RadioDelegate Control

    \image qtquickcontrols2-radiodelegate.gif

    \l 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.

    \b {See also} \l {RadioButton Control}.

    \section1 SwipeDelegate Control

    \image qtquickcontrols2-swipedelegate.gif

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

    \section1 SwitchDelegate Control

    \image qtquickcontrols2-switchdelegate.gif

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

    \b {See also} \l {Switch Control}.

    \section1 TreeViewDelegate Control

    \image qtquickcontrols2-treeviewdelegate.png

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

    \b {See also} \l {TreeView Control}.

    \section1 Related Information
    \list
    \li \l {Qt Quick Controls Guidelines}
    \endlist
*/