Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
qtquickcontrols-containers.qdoc
Go to the documentation of this file.
1// Copyright (C) 2017 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
3
4/*!
5 \page qtquickcontrols-containers.html
6 \title Container Controls
7 \ingroup qtquickcontrols-guidelines
8 \brief Guidelines for container controls
9
10 Qt Quick Controls offers a selection of container-like controls.
11
12 \annotatedlist qtquickcontrols-containers
13
14 Each type of container can be used to group a set of controls together.
15 The following sections offer guidelines for choosing the appropriate type
16 of container, depending on the use case.
17
18 \section1 ApplicationWindow Control
19
20 \image qtquickcontrols-applicationwindow-wireframe.png
21
22 \l ApplicationWindow creates the root window of an application, and makes
23 it easy to add an optional header and footer to that window.
24
25 \section1 Frame Control
26
27 \image qtquickcontrols-frame.png
28
29 \l Frame is used to layout a logical group of controls together, within
30 a visual frame.
31
32 \section1 GroupBox Control
33
34 \image qtquickcontrols-groupbox.png
35
36 \l GroupBox is used to layout a logical group of controls together,
37 within a titled visual frame.
38
39 \section1 Page Control
40
41 \image qtquickcontrols-page-wireframe.webp
42
43 \l Page provides page-specific header and footer items.
44 It is perfectly possible to use ApplicationWindow for setting the header
45 and the footer, but if you have a header and footer which varies per
46 screen, then it is better to use \l Page.
47
48 \section1 Pane Control
49
50 \image qtquickcontrols-pane.png
51
52 \l Pane provides a background color that matches with the application
53 style and theme. Pane does not provide a layout of its own, but requires
54 you to position its contents, for instance by using a \l RowLayout or
55 a \l ColumnLayout.
56
57 \section1 ScrollView Control
58
59 \image qtquickcontrols-scrollview-wireframe.webp
60
61 \l ScrollView provides scrolling for user-defined content.
62
63 \section1 StackView Control
64
65 \image qtquickcontrols-stackview-wireframe.webp
66
67 \l StackView organizes content pages into a stack using a last-in-first-out
68 principle: the last item to be "pushed" onto the stack is the first one to
69 be removed, and the top-most item is always the one that is visible.
70
71 \section1 SwipeView Control
72
73 \image qtquickcontrols-swipeview-wireframe.webp
74
75 \l SwipeView organizes content pages into a swipable strip.
76
77 \section1 TabBar Control
78
79 \image qtquickcontrols-tabbar-wireframe.webp
80
81 \l TabBar organizes content pages into tabs.
82
83 \section1 ToolBar Control
84
85 \image qtquickcontrols-toolbar.png
86
87 \l ToolBar is a container of application-wide and context-sensitive
88 actions and controls.
89*/