Отличия от 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