Тип QML Theme3D

Визуальный стиль для графиков. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• ambientLightStrength : real
• backgroundColor : цвет
• backgroundEnabled : bool
• baseColors : список<ThemeColor>
• baseGradients : список<ColorGradient>
• colorStyle : Theme3D.ColorStyle
• font : шрифт
• gridEnabled : bool
• gridLineColor : цвет
• highlightLightStrength : real
• labelBackgroundColor : цвет
• labelBackgroundEnabled : bool
• labelBorderEnabled : bool
• labelTextColor : цвет
• lightColor : цвет
• lightStrength : real
• multiHighlightColor : цвет
• multiHighlightGradient : ColorGradient
• singleHighlightColor : цвет
• singleHighlightGradient : ColorGradient
• type : Theme3D.Theme
• windowColor : цвет

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

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

Следующие свойства могут быть переопределены с помощью свойств Abstract3DSeries для явного их задания в серии: baseColors, baseGradients и colorStyle.

Темы можно создавать с нуля, используя значение перечисления Theme3D.ThemeUserDefined.

Тема по умолчанию

В следующей таблице перечислены свойства, контролируемые темами, и значения по умолчанию для Theme3D.ThemeUserDefined.

Примеры использования

Использование встроенной темы без каких-либо изменений:

Scatter3D {
    ...
    theme: Theme3D { type: Theme3D.ThemeRetro }
    ...
}

Использование встроенной темы и изменение некоторых свойств:

Bars3D {
    ...
    theme: Theme3D {
        type: Theme3D.ThemeRetro
        labelBorderEnabled: true
        font.pointSize: 35
        labelBackgroundEnabled: false
    }
    ...
}

Использование пользовательской темы:

Surface3D {
    ...
    theme: Theme3D {
        ambientLightStrength: 0.5
        backgroundColor: "red"
        backgroundEnabled: true
        baseColor: "blue"
        colorStyle: Theme3D.ColorStyleUniform
        font.family: "Lucida Handwriting"
        font.pointSize: 35
        gridEnabled: false
        gridLineColor: "black"
        highlightLightStrength: 0.5
        labelBackgroundColor: "black"
        labelBackgroundEnabled: true
        labelBorderEnabled: false
        labelTextColor: "white"
        lightColor: "yellow"
        lightStrength: 0.4
        multiHighlightColor: "green"
        singleHighlightColor: "darkRed"
        windowColor: "white"
    }
    ...
}

Для перечислений Theme3D см. Q3DTheme::ColorStyle и Q3DTheme::Theme.

Документация свойств

ambientLightStrength : real

Сила рассеянного света для всего графика. Это значение определяет, насколько равномерно и ярко отображаются цвета на графике независимо от положения источника света. Значение должно быть между 0.0 и 1.0.

backgroundColor : цвет

Цвет фона графика.

backgroundEnabled : bool

Определяет, отрисовывается ли фон с использованием значения backgroundColor.

baseColors : список<ThemeColor>

Список базовых цветов, используемых для всех объектов на графике, по сериям. Если серий больше, чем цветов, список цветов циклически повторяется, начиная с первого цвета в списке. Не имеет немедленного эффекта, если colorStyle не Theme3D.ColorStyleUniform.

Это можно переопределить, явно задав Abstract3DSeries.baseColor в серии.

baseGradients : список<ColorGradient>

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

Не имеет немедленного эффекта, если colorStyle равен Theme3D.ColorStyleUniform.

Это значение можно переопределить, задав Abstract3DSeries.baseGradient явно в серии.

colorStyle : Theme3D.ColorStyle

Стиль цветов графика. Одно из значений перечисления Q3DTheme::ColorStyle.

Это значение можно переопределить, явно задав Abstract3DSeries.colorStyle в серии.

См. также Q3DTheme::ColorStyle.

font : шрифт

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

gridEnabled : bool

Определяет, будут ли отображаться линии сетки. Это значение влияет на все линии сетки.

gridLineColor : цвет

Цвет линий сетки.

highlightLightStrength : вещественное

Сила рассеянного света для выделенных объектов. Значение должно быть в диапазоне от 0.0 до 10.0.

labelBackgroundColor : цвет

Цвет фона меток. Не оказывает влияния, если labelBackgroundEnabled равен false.

labelBackgroundEnabled : логическое

Определяет, будет ли метка отображаться с фоном, использующим labelBackgroundColor (включая альфа-канал), или с полностью прозрачным фоном. Метки с фоном рисуются с одинаковыми размерами по каждой оси, исходя из самой длинной метки, а текст центрируется внутри них. Метки без фона рисуются как есть и выравниваются по левому или правому краю в зависимости от их позиции на графике.

labelBorderEnabled : логическое

Определяет, будут ли отображаться рамки меток для меток с фоном. Не оказывает влияния, если labelBackgroundEnabled равен false.

labelTextColor : цвет

Цвет шрифта, используемого для меток.

lightColor : цвет

Цвет окружающего и рассеянного света, определённого в Scene3D.

lightStrength : вещественное

Сила рассеянного света для всего графика. Значение должно быть в диапазоне от 0.0 до 10.0.

Это значение влияет на свет, указанный в Scene3D.

multiHighlightColor : цвет

Цвет выделения для выбранных объектов. Используется, если у selectionMode установлен флаг AbstractGraph3D.SelectionRow или AbstractGraph3D.SelectionColumn.

multiHighlightGradient : ColorGradient

Градиент выделения для выбранных объектов. Используется, если у selectionMode установлен флаг AbstractGraph3D.SelectionRow или AbstractGraph3D.SelectionColumn.

singleHighlightColor : цвет

Цвет выделения для выбранного объекта. Используется, если у selectionMode установлен флаг AbstractGraph3D.SelectionItem.

singleHighlightGradient : ColorGradient

Градиент выделения для выбранного объекта. Используется, если у selectionMode установлен флаг AbstractGraph3D.SelectionItem.

type : Theme3D.Theme

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

windowColor : цвет

Цвет окна приложения, в котором отображается график.