Spec-Zone.ru › Qt 5.15

Тип QML Theme3D

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

Заявление об импорте: import QtDataVisualization 1.15
С момента: QtDataVisualization 1.0
Создаёт экземпляр: Q3DTheme
  • Список всех членов, включая унаследованные

Свойства

  • ambientLightStrength : real
  • цветФона : цвет
  • backgroundEnabled : bool
  • baseColors : список<ThemeColor>
  • baseGradients : список<ColorGradient>
  • стильЦвета : Theme3D.ColorStyle
  • шрифт : шрифт
  • gridEnabled : bool
  • цветЛинииСетки : цвет
  • highlightLightStrength : real
  • цветФонаМетки : цвет
  • labelBackgroundEnabled : bool
  • labelBorderEnabled : bool
  • цветТекстаМетки : цвет
  • цветСвета : цвет
  • силаСвета : real
  • цветМногократногоВыделения : цвет
  • многократноеВыделениеГрадиент : ColorGradient
  • цветЕдиногоВыделения : цвет
  • единичноеВыделениеГрадиент : ColorGradient
  • тип : Theme3D.Theme
  • цветОкна : цвет

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

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

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

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

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

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

Свойство Значение по умолчанию
ambientLightStrength 0.25
цветФона "черный". Для получения дополнительной информации см. цвет.
backgroundEnabled true
baseColors "черный"
baseGradients QLinearGradient. В основном полностью черный.
стильЦвета ColorStyleUniform
шрифт шрифт
gridEnabled true
цветЛинииСетки "белый"
highlightLightStrength 7.5
цветФонаМетки "серый"
labelBackgroundEnabled true
labelBorderEnabled true
цветТекстаМетки "белый"
цветСвета "белый"
силаСвета 5.0
цветМногократногоВыделения "синий"
многократноеВыделениеГрадиент QLinearGradient. В основном полностью черный.
цветЕдиногоВыделения "красный"
единичноеВыделениеГрадиент QLinearGradient. В основном полностью черный.
цветОкна "черный"

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

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

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.

цветФона : цвет

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

backgroundEnabled : bool

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

baseColors : список<ThemeColor>

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

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

baseGradients : список<ColorGradient>

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

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

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

стильЦвета : Theme3D.ColorStyle

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

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

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

шрифт : шрифт

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

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

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

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qml-qtdatavisualization-theme3d.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API