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 Quick Controls доступен по коммерческим лицензиям от The Qt Company. Кроме того, он доступен по лицензии GNU Lesser General Public License, version 3 или GNU General Public License, version 2. Дополнительные сведения см. в Qt Licensing.

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

Разделы

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

Справочник

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

Примеры

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

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

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