Универсальный стиль

Универсальный стиль основан на Руководстве по универсальному дизайну Microsoft. Подробнее...

Присоединённые свойства

• акцент : цвет
• фон : цвет
• первый план : цвет
• тема : перечисление

Присоединённые методы

• цвет цвет(предварительно определённое перечисление)

Подробное описание

Универсальный стиль — это независимый от устройства стиль, основанный на Руководстве по универсальному дизайну Microsoft. Универсальный стиль разработан для хорошего отображения на всех устройствах, от телефонов и планшетов до ПК.

Чтобы запустить приложение с универсальным стилем, см. Использование стилей в Qt Quick Controls.

Настройка

Универсальный стиль позволяет настраивать четыре атрибута: тема, акцент, первый план и фон.

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

import QtQuick 2.12
import QtQuick.Controls 2.12
import QtQuick.Controls.Universal 2.12

ApplicationWindow {
    visible: true

    Universal.theme: Universal.Dark
    Universal.accent: Universal.Violet

    Column {
        anchors.centerIn: parent

        RadioButton { text: qsTr("Small") }
        RadioButton { text: qsTr("Medium");  checked: true }
        RadioButton { text: qsTr("Large") }
    }
}

Помимо указания атрибутов в QML, их также можно указать через переменные среды или в файле конфигурации. Атрибуты, указанные в QML, имеют приоритет над всеми другими методами.

Файл конфигурации

См. Файл конфигурации Qt Quick Controls для получения более подробной информации о файле конфигурации.

Переменные среды

См. Поддерживаемые переменные среды в Qt Quick Controls для получения полного списка поддерживаемых переменных среды.

Зависимость

Универсальный стиль должен быть импортирован отдельно, чтобы получить доступ к атрибутам, специфичным для универсального стиля. Следует отметить, что независимо от ссылок на универсальный стиль, тот же код приложения работает с любым другим стилем. Атрибуты, специфичные для универсального стиля, имеют эффект только при запуске приложения с универсальным стилем.

Если универсальный стиль импортирован в файл QML, который всегда загружается, универсальный стиль должен быть развернут с приложением, чтобы приложение можно было запустить независимо от того, какой стиль используется для запуска приложения. Используя выбор файлов, можно применять настройки, специфичные для стиля, без создания жёсткой зависимости от стиля.

Предварительно определённые универсальные цвета

Доступные предварительно определённые цвета:

См. также Базовый стиль, Материал стиль

Документация по присоединённому свойству

Universal.акцент : цвет

Это присоединённое свойство содержит цвет акцента темы. Свойство может быть присоединён к любому окну или элементу. Значение распространяется на потомков.

Значение по умолчанию — Universal.Cobalt.

В следующем примере цвет акцента выделенной кнопки изменён на Universal.Orange:

Button {
    text: qsTr("Button")
    highlighted: true
    Universal.accent: Universal.Orange
}

Universal.фон : цвет

Это присоединённое свойство содержит цвет фона темы. Свойство может быть присоединён к любому окну или элементу. Значение распространяется на потомков.

Значение по умолчанию зависит от темы (светлая или тёмная).

В следующем примере цвет фона панели изменяется на Universal.Steel:

Pane {
    Universal.background: Universal.Steel

    Button {
        text: qsTr("Button")
    }
}

Universal.foreground : цвет

Это присоединённое свойство содержит цвет переднего плана темы. Свойство может быть присоединённо к любому окну или элементу. Значение передаётся потомкам.

Значение по умолчанию зависит от темы (светлая или тёмная).

В следующем примере цвет переднего плана кнопки задаётся как Universal.Pink:

Button {
    text: qsTr("Button")
    Universal.foreground: Universal.Pink
}

Universal.theme : перечисление

Это присоединённое свойство указывает, является ли тема светлой или тёмной. Свойство может быть присоединённо к любому окну или элементу. Значение передаётся потомкам.

Доступные темы:

Установив тему на System, выбирается светлая или тёмная тема в зависимости от цветов системной темы. Однако при чтении значения свойства темы, значение никогда не будет System, а будет фактической темой.

В следующем примере тема для панели и кнопки установлена как Universal.Dark:

Pane {
    Universal.theme: Universal.Dark

    Button {
        text: qsTr("Button")
    }
}

Документация по присоединённым методам

цвет color(перечисление predefined)

Этот присоединённый метод возвращает эффективное значение цвета указанного предварительно определённого цвета Universal.

Rectangle {
    color: Universal.color(Universal.Red)
}

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

• Стилизация Qt Quick Controls