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

Универсальный стиль основан на руководящих принципах универсального дизайна Microsoft. Подробнее...

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

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

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

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

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

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

Для запуска приложения с универсальным стилем см. Использование стилей в Qt Quick Controls 2.

Примечание: Универсальный стиль не является родным стилем Windows 10. Универсальный стиль — это 100% кроссплатформенная реализация стиля Qt Quick Controls 2, которая следует руководящим принципам универсального дизайна Microsoft. Стиль работает на любой платформе и выглядит более или менее одинаково повсюду. Незначительные различия могут возникать из-за различий в доступных системных шрифтах и движках рендеринга шрифтов.

Настройка

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

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

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 2.

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

Полный список поддерживаемых переменных среды см. в Поддерживаемых переменных среды в Qt Quick Controls 2.

Зависимость

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

Если универсальный стиль импортирован в файле 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.передний план : цвет

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

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

В приведенном ниже примере цвет фона кнопки задан на 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)

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

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

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

• Стилевое оформление Qt Quick Controls 2