aboutsummaryrefslogtreecommitdiffstats
path: root/src/quickcontrols/doc/src/qtquickcontrols-delegates.qdoc
blob: a3fee8b5ae9f2a86ad19608e6fc0f92d04ee7c66 (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 qtquickcontrols-delegates.html
    \title Delegate Controls
    \ingroup qtquickcontrols-guidelines
    \brief Guidelines for delegate controls

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

    \annotatedlist qtquickcontrols-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 qtquickcontrols-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 qtquickcontrols-itemdelegate.gif

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

    \section1 RadioDelegate Control

    \image qtquickcontrols-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 qtquickcontrols-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 qtquickcontrols-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 qtquickcontrols-treeviewdelegate.png

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

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

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