Тип QML Theme3D

Стиль отображения графиков. Подробнее...

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

Свойства

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

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

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

Следующие свойства могут быть переопределены с помощью свойств 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 : color

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

backgroundEnabled : bool

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

baseColors : list<ThemeColor>

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

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

baseGradients : list<ColorGradient>

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

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

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

colorStyle : Theme3D.ColorStyle

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

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

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

font : 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 : цвет

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