Тип 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 : real

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

labelBackgroundColor : color

Цвет фона подписей. Не имеет эффекта, если labelBackgroundEnabled равен false.

labelBackgroundEnabled : bool

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

labelBorderEnabled : bool

Определяет, отображаются ли рамки подписей для подписей с фоном. Не имеет эффекта, если labelBackgroundEnabled равен false.

labelTextColor : color

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

lightColor : color

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

lightStrength : real

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

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

multiHighlightColor : color

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

multiHighlightGradient : ColorGradient

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

singleHighlightColor : color

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

singleHighlightGradient : ColorGradient

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

type : Theme3D.Theme

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

windowColor : color

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