Отличия от Qt Quick Controls 1

Qt Quick Controls 1 изначально разрабатывался для поддержки настольных платформ, а мобильная и встроенная поддержка появилась чуть позже. Они обладают очень широким охватом, так как предоставляют систему стилей, достаточно гибкую для разработки приложений с зависимым или независимым от платформы стилем.

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

C++ и QML

Во многих случаях внутреннее состояние элемента управления может быть более эффективно обработано в C++. Например, обработка событий ввода в C++ влияет на элементы управления, которые в противном случае должны создавать внутренние объекты MouseAreas и Keys.

Стили

Обработка событий и логики в C++ не только повышает производительность, но и позволяет визуальному слою QML быть простым декларативным слоем сверху. Это отражается в структуре проекта элементов управления: все визуальные реализации находятся в папке imports, поэтому пользователи, которые хотят создать свой собственный полный стиль, могут скопировать папку и начать его настройку. Подробнее о реализации плагина стиля читайте здесь.

В Qt Quick Controls стили больше не предоставляют компоненты, которые динамически создаются элементами управления, но сами элементы управления состоят из делегатов элементов, которые могут быть заменены. По сути, это означает, что делегаты являются элементами Qt Quick, которые создаются на месте, как свойства элемента управления, и просто добавляются в качестве дочернего элемента к элементу управления.

Модульность и Простота

В случае более сложных элементов управления иногда лучше разделить их на отдельные строительные блоки. Например, сложный элемент ScrollView:

ScrollView {
    horizontalScrollBarPolicy: Qt.ScrollBarAlwaysOff
    Flickable {
        // ...
    }
}

Заменяется простыми элементами ScrollBar/ScrollIndicator, которые можно прикрепить к любому Flickable:

Flickable {
    // ...
    ScrollBar.vertical: ScrollBar { }
}

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

Таблица сравнения функций

1. Не поддерживается официально, но технически возможно через закрытые API
2. Только темы для определённых стилей могут быть изменены во время выполнения, стили фиксированы
3. Производительность может быть не оптимальной

Перенос кода Qt Quick Controls 1

API Qt Quick Controls очень похож на API Qt Quick Controls 1, но в нём есть некоторые изменения, необходимые для улучшений. Большинство изменений касаются стилей; все делегаты элемента управления теперь доступны в самом элементе управления, а не в отдельном объекте стиля.

Например, для стилизации кнопки в Qt Quick Controls 1:

Button {
    style: ButtonStyle {
        label: Label {
            // ...
        }
    }
}

Для стилизации кнопки в Qt Quick Controls:

Button {
    contentItem: Label {
        // ...
    }
}

Подготовка к миграции

С учётом этого, хорошим способом подготовки к миграции на Qt Quick Controls 2 является размещение каждого элемента управления, для которого у вас есть пользовательский стиль, в отдельном файле QML. Например, кнопку Qt Quick Controls 1 выше можно перенести в файл под названием Button.qml в каталоге controls, и использовать её следующим образом:

import "controls" as Controls

Controls.Button {
    // ...
}

Это работает с обеими модулями и сократит объём работы при начале миграции.

Таблица сравнения типов

В первой колонке перечислены все типы, доступные в Qt Quick Controls 1, Qt Quick Dialogs и Qt Quick Extras. Во второй колонке описан соответствующий тип в Qt Quick Controls. Если прямой аналог отсутствует, в третьей колонке указана альтернатива, обеспечивающая аналогичную функциональность. В последней колонке приведены некоторые замечания об отличиях типов в разных модулях.

Связанная информация

• Qt Quick
• Типы QML Qt Quick Controls
• Типы QML Qt Quick Controls 1
• Типы QML Qt Quick Extras
• Типы QML Qt Labs Calendar
• Типы QML Qt Labs Platform