Различия между Qt Quick Controls

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

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

C++ и QML

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

Стили

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

import "controls" as Controls

Controls.Button {
    ...
}

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

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

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

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

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