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, где версии импорта соответствуют незначительной версии Qt.

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

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

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

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

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

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 Quick Calendar
• Qt Quick Calendar
• Qt Labs Platform