Qt Quick Controls

Qt Quick Controls предоставляет набор элементов управления, которые можно использовать для построения полных интерфейсов в Qt Quick. Модуль был представлен в Qt 5.7.

Qt Quick Controls поставляется с настраиваемыми стилями. Подробнее см. Стили Qt Quick Controls.

Использование модуля

QML API

Типы QML можно импортировать в ваше приложение, используя следующую инструкцию импорта в вашем файле .qml:

import QtQuick.Controls

C++ API

Использование C++ API требует привязки к библиотеке модуля, либо напрямую, либо через другие зависимости. Несколько инструментов сборки имеют поддержку этого, включая CMake и qmake.

Сборка с помощью CMake

Используйте команду find_package() для поиска необходимых компонентов модуля в пакете Qt6:

find_package(Qt6 COMPONENTS QuickControls2 REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::QuickControls2)

См. также обзор Сборки с помощью CMake.

Сборка с помощью qmake

Для настройки модуля для сборки с помощью qmake, добавьте модуль как значение переменной QT в файле проекта .pro:

QT += quickcontrols2

Сборка из исходного кода

Модуль Qt Image Formats рекомендуется, но не является обязательным. Он предоставляет поддержку формата .webp используемого стилем Imagine.

Версии

Qt Quick Controls 2.0 был представлен в Qt 5.7. Последующие незначительные версии Qt увеличивают версию импорта модулей Qt Quick Controls на единицу, до Qt 5.12, где версии импорта соответствуют значению minor версии Qt.

В Qt 6, и major, и minor версии совпадают, и номера версий можно опустить из импортов в QML. Если версия опущена, будет использоваться последняя версия.

Экспериментальные модули Qt Labs используют версию импорта 1.0.

Эволюция модуля

Изменения в Qt Quick Controls перечисляет важные изменения в API и функциональности модуля, внесенные для серии Qt 6.

Лицензия и авторские права

Qt Quick Controls доступен по коммерческим лицензиям от The Qt Company. Кроме того, он доступен по лицензии GNU Lesser General Public License, version 3 или GNU General Public License, version 2. Подробнее см. Лицензирование Qt.

Кроме того, Qt Quick Controls потенциально содержит модули сторонних разработчиков по следующим разрешительным лицензиям:

Разделы

• Начало работы
• Рекомендации
• Стилизация
• Иконки
• Настройка
• Использование файловых селекторов
• Развертывание
• Файл конфигурации
• Переменные среды

Справочник

• QML Типы
• Классы C++

Примеры

• Галерея
• Учебник по чатам
• Редактор текста
• Демо-версия носимых устройств
• Пример автомобильного интерфейса
• Пример музыкального плеера
• Все примеры

Связанные модули

• Qt Quick
• Qt Quick Layouts
• Qt Quick Templates 2
• Qt Labs Platform