Класс Q3DTheme
Q3DTheme класс предоставляет визуальный стиль для графиков. Подробнее...
| Заголовок: | #include <Q3DTheme> |
| С момента: | QtDataVisualization 1.0 |
| Инициализируется: | Theme3D |
| Наследует: | QObject |
Типы
| Перечисление | ColorStyle { ColorStyleUniform, ColorStyleObjectGradient, ColorStyleRangeGradient } |
| Перечисление | Theme { ThemeQt, ThemePrimaryColors, ThemeDigia, ThemeStoneMoss, ..., ThemeUserDefined } |
Свойства
|
|
- 1 свойство унаследовано от QObject
Открытые функции
| Q3DTheme(QObject *parent = nullptr) | |
| Q3DTheme(Q3DTheme::Theme themeType, QObject *parent = nullptr) | |
| virtual | ~Q3DTheme() |
| float | сила_окружающего_света() const |
| QColor | цвет_фона() const |
| QList<QColor> | основные_цвета() const |
| QList<QLinearGradient> | основные_градиенты() const |
| Q3DTheme::ColorStyle | стиль_цвета() const |
| QFont | шрифт() const |
| QColor | цвет_линии_сетки() const |
| float | сила_выделяющего_света() const |
| bool | фон_активирован() const |
| bool | сетка_активирована() const |
| bool | фоны_меток_активированы() const |
| bool | рамки_меток_активированы() const |
| QColor | цвет_фона_меток() const |
| QColor | цвет_текста_меток() const |
| QColor | цвет_света() const |
| float | сила_света() const |
| QColor | цвет_многократного_выделения() const |
| QLinearGradient | градиент_многократного_выделения() const |
| void | установитьСилуОкружающегоСвета(float strength) |
| void | установитьЦветФона(const QColor &color) |
| void | установитьФонАктивирован(bool enabled) |
| void | установитьОсновныеЦвета(const QList<QColor> &colors) |
| void | установитьОсновныеГрадиенты(const QList<QLinearGradient> &gradients) |
| void | установитьСтильЦвета(Q3DTheme::ColorStyle style) |
| void | установитьШрифт(const QFont &font) |
| void | установитьСеткуАктивирована(bool enabled) |
| void | установитьЦветЛинииСетки(const QColor &color) |
| void | установитьСилуВыделяющегоСвета(float strength) |
| void | установитьЦветФонаМетки(const QColor &color) |
| void | установитьФоныМетокАктивированы(bool enabled) |
| void | установитьРамкиМетокАктивированы(bool enabled) |
| void | установитьЦветТекстаМетки(const QColor &color) |
| void | установитьЦветСвета(const QColor &color) |
| void | установитьСилуСвета(float strength) |
| void | установитьЦветМногократногоВыделения(const QColor &color) |
| void | установитьГрадиентМногократногоВыделения(const QLinearGradient &gradient) |
| void | установитьЦветОднократногоВыделения(const QColor &color) |
| void | установитьГрадиентОднократногоВыделения(const QLinearGradient &gradient) |
| void | установитьТип(Q3DTheme::Theme themeType) |
| void | установитьЦветОкна(const QColor &color) |
| QColor | цвет_однократного_выделения() const |
| QLinearGradient | градиент_однократного_выделения() const |
| Q3DTheme::Theme | тип() const |
| QColor | цвет_окна() const |
- 31 public functions inherited from QObject
Сигналы
| void | ambientLightStrengthChanged(float strength) |
| void | backgroundColorChanged(const QColor &color) |
| void | backgroundEnabledChanged(bool enabled) |
| void | baseColorsChanged(const QList<QColor> &colors) |
| void | baseGradientsChanged(const QList<QLinearGradient> &gradients) |
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
| void | fontChanged(const QFont &font) |
| void | gridEnabledChanged(bool enabled) |
| void | gridLineColorChanged(const QColor &color) |
| void | highlightLightStrengthChanged(float strength) |
| void | labelBackgroundColorChanged(const QColor &color) |
| void | labelBackgroundEnabledChanged(bool enabled) |
| void | labelBorderEnabledChanged(bool enabled) |
| void | labelTextColorChanged(const QColor &color) |
| void | lightColorChanged(const QColor &color) |
| void | lightStrengthChanged(float strength) |
| void | multiHighlightColorChanged(const QColor &color) |
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
| void | singleHighlightColorChanged(const QColor &color) |
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
| void | typeChanged(Q3DTheme::Theme themeType) |
| void | windowColorChanged(const QColor &color) |
- 2 сигнала унаследованы от QObject
Статические публичные члены
| const QMetaObject | staticMetaObject |
- 9 статических публичных членов унаследованы от QObject
Защищённые переменные
| int | d_ptr |
Дополнительные унаследованные члены
Подробное описание
Q3DTheme класс предоставляет визуальный стиль для графиков.
Устанавливает визуальные свойства, которые влияют на весь график. Существуют несколько встроенных тем, которые можно использовать как есть или свободно изменять.
Следующие свойства могут быть переопределены с помощью свойств QAbstract3DSeries, чтобы установить их явно в серии: baseColors, baseGradients и colorStyle.
Темы могут быть созданы с нуля, используя значение перечисления ThemeUserDefined. Создание темы с помощью конструктора по умолчанию создаёт новую пользовательскую тему.
Тема по умолчанию
В следующей таблице перечислены свойства, контролируемые темами, и значения по умолчанию для ThemeUserDefined.
| Свойство | Значение по умолчанию |
|---|---|
| ambientLightStrength | 0.25 |
| backgroundColor | Qt::black |
| backgroundEnabled | true |
| baseColors | Qt::black |
| baseGradients | QLinearGradient. В основном полностью чёрный. |
| colorStyle | ColorStyleUniform |
| font | QFont |
| gridEnabled | true |
| gridLineColor | Qt::white |
| highlightLightStrength | 7.5 |
| labelBackgroundColor | Qt::gray |
| labelBackgroundEnabled | true |
| labelBorderEnabled | true |
| labelTextColor | Qt::white |
| lightColor | Qt::white |
| lightStrength | 5.0 |
| multiHighlightColor | Qt::blue |
| multiHighlightGradient | QLinearGradient. В основном полностью чёрный. |
| singleHighlightColor | Qt::red |
| singleHighlightGradient | QLinearGradient. В основном полностью чёрный. |
| windowColor | Qt::black |
Примеры использования
Создание встроенной темы без каких-либо изменений:
Q3DTheme *theme = new Q3DTheme(Q3DTheme::ThemeQt);
Создание встроенной темы и изменение некоторых свойств:
Q3DTheme *theme = new Q3DTheme(Q3DTheme::ThemeQt); theme->setBackgroundEnabled(false); theme->setLabelBackgroundEnabled(false);
Создание пользовательской темы:
Q3DTheme *theme = new Q3DTheme();
theme->setAmbientLightStrength(0.3f);
theme->setBackgroundColor(QColor(QRgb(0x99ca53)));
theme->setBackgroundEnabled(true);
theme->setBaseColor(QColor(QRgb(0x209fdf)));
theme->setColorStyle(Q3DTheme::ColorStyleUniform);
theme->setFont(QFont(QStringLiteral("Impact"), 35));
theme->setGridEnabled(true);
theme->setGridLineColor(QColor(QRgb(0x99ca53)));
theme->setHighlightLightStrength(7.0f);
theme->setLabelBackgroundColor(QColor(0xf6, 0xa6, 0x25, 0xa0));
theme->setLabelBackgroundEnabled(true);
theme->setLabelBorderEnabled(true);
theme->setLabelTextColor(QColor(QRgb(0x404044)));
theme->setLightColor(Qt::white);
theme->setLightStrength(6.0f);
theme->setMultiHighlightColor(QColor(QRgb(0x6d5fd5)));
theme->setSingleHighlightColor(QColor(QRgb(0xf6a625)));
theme->setWindowColor(QColor(QRgb(0xffffff))); Создание встроенной темы и изменение некоторых свойств после того, как она была установлена:
Q3DBars *graph = new Q3DBars(); graph->activeTheme()->setType(Q3DTheme::ThemePrimaryColors); graph->activeTheme()->setBaseColor(Qt::red); graph->activeTheme()->setSingleHighlightColor(Qt::yellow);
Документация по типу члена
перечисление Q3DTheme::ColorStyle
Стили цвета.
| Постоянная | Значение | Описание |
|---|---|---|
Q3DTheme::ColorStyleUniform |
0 |
Объекты отображаются в одном цвете. Используемый цвет задается свойствами baseColors, singleHighlightColor и multiHighlightColor. |
Q3DTheme::ColorStyleObjectGradient |
1 |
Объекты окрашиваются с использованием полного градиента для каждого объекта независимо от высоты объекта. Используемый градиент задается свойствами baseGradients, singleHighlightGradient и multiHighlightGradient. |
Q3DTheme::ColorStyleRangeGradient |
2 |
Объекты окрашиваются с использованием части полного градиента, определяемой высотой объекта и его положением на оси Y. Используемый градиент задается свойствами baseGradients, singleHighlightGradient и multiHighlightGradient. |
enum Q3DTheme::Theme
Встроенные темы.
| Постоянная | Значение | Описание |
|---|---|---|
Q3DTheme::ThemeQt |
0 |
Светлая тема с зелёным базовым цветом. |
Q3DTheme::ThemePrimaryColors |
1 |
Светлая тема с жёлтым базовым цветом. |
Q3DTheme::ThemeDigia |
2 |
Светлая тема с серым базовым цветом. |
Q3DTheme::ThemeStoneMoss |
3 |
Средне-тёмная тема с жёлтым базовым цветом. |
Q3DTheme::ThemeArmyBlue |
4 |
Средне-светлая тема с синим базовым цветом. |
Q3DTheme::ThemeRetro |
5 |
Средне-светлая тема с коричневым базовым цветом. |
Q3DTheme::ThemeEbony |
6 |
Тёмная тема с белым базовым цветом. |
Q3DTheme::ThemeIsabelle |
7 |
Тёмная тема с жёлтым базовым цветом. |
Q3DTheme::ThemeUserDefined |
8 |
Пользовательская тема. Для получения дополнительной информации, см. Стандартную тему. |
Документация по свойствам
ambientLightStrength : float
Это свойство хранит значение яркости фоновой подсветки для всего графа.
Это значение определяет, насколько равномерно и ярко отображаются цвета по всему графу независимо от положения источника света.
Значение должно находиться в диапазоне от 0.0f до 1.0f.
Функции доступа:
| float | ambientLightStrength() const |
| void | setAmbientLightStrength(float strength) |
Сигнал уведомления:
| void | ambientLightStrengthChanged(float strength) |
backgroundColor : QColor
Это свойство хранит цвет фона графа.
Функции доступа:
| QColor | backgroundColor() const |
| void | setBackgroundColor(const QColor &color) |
Сигнал уведомления:
| void | backgroundColorChanged(const QColor &color) |
backgroundEnabled : bool
Это свойство хранит информацию о видимости фона.
Фон отрисовывается с использованием значения backgroundColor.
Функции доступа:
| bool | isBackgroundEnabled() const |
| void | setBackgroundEnabled(bool enabled) |
Сигнал уведомления:
| void | backgroundEnabledChanged(bool enabled) |
baseColors : QList<QColor>
Это свойство хранит список базовых цветов, которые будут использоваться для всех объектов на графике, серия за серией.
Если серий больше, чем цветов, список цветов повторяется, начиная с первого цвета в списке.
Не оказывает непосредственного влияния, если colorStyle не является ColorStyleUniform.
Это значение может быть переопределено путем явного задания baseColor в серии.
Функции доступа:
| QList<QColor> | baseColors() const |
| void | setBaseColors(const QList<QColor> &colors) |
Сигнал уведомления:
| void | baseColorsChanged(const QList<QColor> &colors) |
baseGradients : QList<QLinearGradient>
Это свойство хранит список базовых градиентов, которые будут использоваться для всех объектов на графике, серия за серией.
Если серий больше, чем градиентов, список градиентов повторяется, начиная с первого градиента в списке.
Не оказывает непосредственного влияния, если colorStyle является ColorStyleUniform.
Это значение может быть переопределено путем явного задания baseGradient в серии.
Функции доступа:
| QList<QLinearGradient> | baseGradients() const |
| void | setBaseGradients(const QList<QLinearGradient> &gradients) |
Сигнал уведомления:
| void | baseGradientsChanged(const QList<QLinearGradient> &gradients) |
colorStyle : ColorStyle
Это свойство хранит стиль цветов графика.
Одно из значений перечисления ColorStyle.
Это значение может быть переопределено путем явного задания colorStyle в серии.
Функции доступа:
| Q3DTheme::ColorStyle | colorStyle() const |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
Сигнал уведомления:
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
font : QFont
Это свойство хранит шрифт, который будет использоваться для меток.
Функции доступа:
| QFont | font() const |
| void | setFont(const QFont &font) |
Сигнал уведомления:
| void | fontChanged(const QFont &font) |
gridEnabled : bool
Это свойство хранит информацию о том, отрисовываются ли линии сетки.
Это значение влияет на все линии сетки.
Функции доступа:
| bool | isGridEnabled() const |
| void | setGridEnabled(bool enabled) |
Сигнал уведомления:
| void | gridEnabledChanged(bool enabled) |
gridLineColor : QColor
Это свойство хранит цвет линий сетки.
Функции доступа:
| QColor | gridLineColor() const |
| void | setGridLineColor(const QColor &color) |
Сигнал уведомления:
| void | gridLineColorChanged(const QColor &color) |
highlightLightStrength : float
Это свойство хранит значение яркости бликов для выделенных объектов.
Значение должно находиться в диапазоне от 0.0f до 10.0f.
Функции доступа:
| float | highlightLightStrength() const |
| void | setHighlightLightStrength(float strength) |
Сигнал уведомления:
| void | highlightLightStrengthChanged(float strength) |
labelBackgroundColor : QColor
Это свойство хранит цвет фонов меток.
Не оказывает влияния, если labelBackgroundEnabled является false.
Функции доступа:
| QColor | labelBackgroundColor() const |
| void | setLabelBackgroundColor(const QColor &color) |
Сигнал уведомления:
| void | labelBackgroundColorChanged(const QColor &color) |
labelBackgroundEnabled : bool
Это свойство указывает, отображается ли метка с фоном цвета или полностью прозрачным фоном.
Значение labelBackgroundColor (включая альфа-канал) используется для отрисовки фона.
Метки с фоном рисуются с одинаковыми размерами по каждой оси, исходя из самой длинной метки, а текст центрируется внутри. Метки без фона рисуются как есть и выравниваются по левому или правому краю в зависимости от их положения на графике.
Функции доступа:
| bool | isLabelBackgroundEnabled() const |
| void | setLabelBackgroundEnabled(bool enabled) |
Сигнал уведомления:
| void | labelBackgroundEnabledChanged(bool enabled) |
labelBorderEnabled : bool
Это свойство указывает, отрисовываются ли рамки меток для меток, имеющих фон.
Не имеет эффекта, если labelBackgroundEnabled равно false.
Функции доступа:
| bool | isLabelBorderEnabled() const |
| void | setLabelBorderEnabled(bool enabled) |
Сигнал уведомления:
| void | labelBorderEnabledChanged(bool enabled) |
labelTextColor : QColor
Это свойство содержит цвет шрифта, используемого для меток.
Функции доступа:
| QColor | labelTextColor() const |
| void | setLabelTextColor(const QColor &color) |
Сигнал уведомления:
| void | labelTextColorChanged(const QColor &color) |
lightColor : QColor
Это свойство содержит цвет для окружающего и зеркального света.
Это значение влияет на свет, заданный в Q3DScene.
Функции доступа:
| QColor | lightColor() const |
| void | setLightColor(const QColor &color) |
Сигнал уведомления:
| void | lightColorChanged(const QColor &color) |
lightStrength : float
Это свойство содержит силу зеркального света для всего графика.
Значение должно быть в диапазоне от 0.0f до 10.0f.
Это значение влияет на свет, заданный в Q3DScene.
Функции доступа:
| float | lightStrength() const |
| void | setLightStrength(float strength) |
Сигнал уведомления:
| void | lightStrengthChanged(float strength) |
multiHighlightColor : QColor
Это свойство содержит цвет выделения для выбранных объектов.
Используется, если свойство selectionMode имеет установленный флаг QAbstract3DGraph::SelectionRow или QAbstract3DGraph::SelectionColumn.
Функции доступа:
| QColor | multiHighlightColor() const |
| void | setMultiHighlightColor(const QColor &color) |
Сигнал уведомления:
| void | multiHighlightColorChanged(const QColor &color) |
multiHighlightGradient : QLinearGradient
Это свойство содержит градиент выделения для выбранных объектов.
Используется, если свойство selectionMode имеет установленный флаг QAbstract3DGraph::SelectionRow или QAbstract3DGraph::SelectionColumn.
Функции доступа:
| QLinearGradient | multiHighlightGradient() const |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
Сигнал уведомления:
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
singleHighlightColor : QColor
Это свойство содержит цвет выделения для одного выбранного объекта.
Используется, если свойство selectionMode имеет установленный флаг QAbstract3DGraph::SelectionItem.
Функции доступа:
| QColor | singleHighlightColor() const |
| void | setSingleHighlightColor(const QColor &color) |
Сигнал уведомления:
| void | singleHighlightColorChanged(const QColor &color) |
singleHighlightGradient : QLinearGradient
Это свойство содержит градиент выделения для одного выбранного объекта.
Используется, если свойство selectionMode имеет установленный флаг QAbstract3DGraph::SelectionItem.
Функции доступа:
| QLinearGradient | singleHighlightGradient() const |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
Сигнал уведомления:
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
type : Theme
Это свойство содержит тип темы.
Тип автоматически устанавливается при создании темы, но также может быть изменён позднее. Изменение типа темы изменит все остальные свойства темы на значения, определённые в предопределённой теме. Изменение типа темы активной темы графика также сбросит все присоединённые ряды, чтобы они использовали новую тему.
Функции доступа:
| Q3DTheme::Theme | type() const |
| void | setType(Q3DTheme::Theme themeType) |
Сигнал уведомления:
| void | typeChanged(Q3DTheme::Theme themeType) |
windowColor : QColor
Это свойство содержит цвет окна приложения, в которое отображается график.
Функции доступа:
| QColor | windowColor() const |
| void | setWindowColor(const QColor &color) |
Сигнал уведомления:
| void | windowColorChanged(const QColor &color) |
Документация функций-членов
Q3DTheme::Q3DTheme(QObject *parent = nullptr)
Создает новую тему типа ThemeUserDefined. Можно указать необязательный параметр parent, который затем передаётся конструктору QObject.
Q3DTheme::Q3DTheme(Q3DTheme::Theme themeType, QObject *parent = nullptr)
Создаёт новую тему с типом themeType, который может быть одним из встроенных типов тем из Theme. Можно указать необязательный параметр parent, который затем передаётся конструктору QObject.
[virtual] Q3DTheme::~Q3DTheme()
Удаляет тему.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.12/q3dtheme.html