Тип QML Theme3D

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

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

Свойства

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

шрифт : шрифт

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

gridEnabled : bool

Определяет, отрисовываются ли линии сетки. Это значение влияет на все линии сетки.

gridLineColor : color

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

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

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