Qt Quick Controls provides QML types for creating user interfaces. These QML types work in conjunction with Qt Quick and Qt Quick Layouts .
Qt Quick Controls QML types can be imported into your application using the following import statement in your .qml file:
import QtQuick.Controls
| AbstractButton | Abstract base type providing functionality common to buttons |
| Action | 抽象用户界面动作 |
| ActionGroup | 把动作分组在一起 |
| ApplicationWindow | Styled top-level window with support for a header and footer |
| BusyIndicator | Indicates background activity, for example, while content is being loaded |
| Button | Push-button that can be clicked to perform a command or answer a question |
| ButtonGroup | Mutually-exclusive group of checkable buttons |
| CheckBox | Check button that can be toggled on or off |
| CheckDelegate | Item delegate with a check indicator that can be toggled on or off |
| ComboBox | Combined button and popup list for selecting options |
| 容器 | Abstract base type providing functionality common to containers |
| Control | Abstract base type providing functionality common to all controls |
| DelayButton | Check button that triggers when held down long enough |
| Dial | Circular dial that is rotated to set a value |
| Dialog | Popup dialog with standard buttons and a title, used for short-term interaction with the user |
| DialogButtonBox | A button box used in dialogs |
| Drawer | Side panel that can be opened and closed using a swipe gesture |
| Frame | Visual frame for a logical group of controls |
| GroupBox | Visual frame and title for a logical group of controls |
| HorizontalHeaderView | Provides a horizontal header view to accompany a TableView |
| ItemDelegate | Basic item delegate that can be used in various views and controls |
| Label | Styled text label with inherited font |
| Menu | Popup that can be used as a context menu or popup menu |
| MenuBar | Provides a window menu bar |
| MenuBarItem | Presents a drop-down menu within a MenuBar |
| MenuItem | Presents an item within a Menu |
| MenuSeparator | Separates a group of items in a menu from adjacent items |
| Overlay | A window overlay for popups |
| Page | Styled page control with support for a header and footer |
| PageIndicator | Indicates the currently active page |
| Pane | Provides a background matching with the application style and theme |
| Popup | Base type of popup-like user interface controls |
| ProgressBar | Indicates the progress of an operation |
| RadioButton | Exclusive radio button that can be toggled on or off |
| RadioDelegate | Exclusive item delegate with a radio indicator that can be toggled on or off |
| RangeSlider | Used to select a range of values by sliding two handles along a track |
| RoundButton | A push-button control with rounded corners that can be clicked by the user |
| ScrollBar | Vertical or horizontal interactive scroll bar |
| ScrollIndicator | Vertical or horizontal non-interactive scroll indicator |
| ScrollView | 可卷动视图 |
| SelectionRectangle | Used to select table cells inside a TableView |
| Slider | Used to select a value by sliding a handle along a track |
| SpinBox | Allows the user to select from a set of preset values |
| SplitHandle | Provides attached properties for SplitView handles |
| SplitView | Lays out items with a draggable splitter between each item |
| StackView | Provides a stack-based navigation model |
| SwipeDelegate | Swipable item delegate |
| SwipeView | Enables the user to navigate pages by swiping sideways |
| Switch | Button that can be toggled on or off |
| SwitchDelegate | Item delegate with a switch indicator that can be toggled on or off |
| TabBar | Allows the user to switch between different views or subtasks |
| TabButton | Button with a look suitable for a TabBar |
| TextArea | 多行文本输入区域 |
| TextField | 单行文本输入字段 |
| ToolBar | Container for context-sensitive controls |
| ToolButton | Button with a look suitable for a ToolBar |
| ToolSeparator | Separates a group of items in a toolbar from adjacent items |
| ToolTip | Provides tool tips for any control |
| Tumbler | Spinnable wheel of items that can be selected |
| VerticalHeaderView | Provides a vertical header view to accompany a TableView |
As mentioned in Qt Quick Templates 2 QML 类型 , each type in Qt Quick Controls is backed by a C++ "template" type. These types are non-visual implementations of controls' logic and behavior .
例如， Menu type's API and behavior is defined by the C++ type in Qt Quick Templates. Each style that wants to provide a Menu must have a Menu.qml available, and the root item in that file must be the Menu from Qt Quick Templates. When you import QtQuick .Controls and create a Menu in QML, the type you get is actually the QML Menu defined by the style's Menu.qml.
In order to use a control as the type in a property declaration, you should use the corresponding type from Qt Quick Templates. For example, suppose you had a
PopupOpener
component, which was a Button that opened a Popup:
// PopupButton.qml
import QtQuick.Controls
Button {
required property Popup popup
onClicked: popup.open()
}
// main.qml
PopupButton {
popup: saveChangesDialog
}
Dialog {
id: saveChangesDialog
// ...
}
Running this code will result in an error:
Unable to assign Dialog_QMLTYPE to Popup_QMLTYPE
This is because of the inheritance hierarchy:
Popup (C++ type in QtQuick.Templates)
│ └── Popup (QML type in QtQuick.Controls)
└── Dialog (C++ type in QtQuick.Templates)
└── Dialog (QML type in QtQuick.Controls)
Dialog from
QtQuick.Controls
does not derive from the Popup from
QtQuick.Controls
, but from
QtQuick.Templates
.
Instead, use the Popup from Qt Quick Templates as the property type:
// PopupButton.qml import QtQuick.Controls import QtQuick.Templates as T Button { required property T.Popup popup onClicked: popup.open() }
有关 Qt Quick Controls 模块的更多信息，见 Qt Quick Controls 模块文档编制。