Класс Q3DTheme
Q3DTheme класс предоставляет визуальный стиль для графиков. Подробнее...
| Заголовок: | #include <Q3DTheme> |
| С тех пор: | QtDataVisualization 1.0 |
| Инициализируется: | Theme3D |
| Наследуется от: | QObject |
Открытые типы
| Перечисление | ColorStyle { ColorStyleUniform, ColorStyleObjectGradient, ColorStyleRangeGradient } |
| Перечисление | Тема { ThemeQt, ThemePrimaryColors, ThemeDigia, ThemeStoneMoss, ..., ThemeUserDefined } |
Свойства
|
|
- 1 свойство унаследовано от QObject
Открытые функции
| Q3DTheme(QObject *parent = nullptr) | |
| Q3DTheme(Q3DTheme::Theme themeType, QObject *parent = nullptr) | |
| virtual | ~Q3DTheme() |
| float | ambientLightStrength() const |
| QColor | backgroundColor() const |
| QList<QColor> | baseColors() const |
| QList<QLinearGradient> | baseGradients() const |
| Q3DTheme::ColorStyle | colorStyle() const |
| QFont | font() const |
| QColor | gridLineColor() const |
| float | highlightLightStrength() const |
| bool | isBackgroundEnabled() const |
| bool | isGridEnabled() const |
| bool | isLabelBackgroundEnabled() const |
| bool | isLabelBorderEnabled() const |
| QColor | labelBackgroundColor() const |
| QColor | labelTextColor() const |
| QColor | lightColor() const |
| float | lightStrength() const |
| QColor | multiHighlightColor() const |
| QLinearGradient | multiHighlightGradient() const |
| void | setAmbientLightStrength(float strength) |
| void | setBackgroundColor(const QColor &color) |
| void | setBackgroundEnabled(bool enabled) |
| void | setBaseColors(const QList<QColor> &colors) |
| void | setBaseGradients(const QList<QLinearGradient> &gradients) |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
| void | setFont(const QFont &font) |
| void | setGridEnabled(bool enabled) |
| void | setGridLineColor(const QColor &color) |
| void | setHighlightLightStrength(float strength) |
| void | setLabelBackgroundColor(const QColor &color) |
| void | setLabelBackgroundEnabled(bool enabled) |
| void | setLabelBorderEnabled(bool enabled) |
| void | setLabelTextColor(const QColor &color) |
| void | setLightColor(const QColor &color) |
| void | setLightStrength(float strength) |
| void | setMultiHighlightColor(const QColor &color) |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
| void | setSingleHighlightColor(const QColor &color) |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
| void | setType(Q3DTheme::Theme themeType) |
| void | setWindowColor(const QColor &color) |
| QColor | singleHighlightColor() const |
| QLinearGradient | singleHighlightGradient() const |
| Q3DTheme::Theme | type() const |
| QColor | windowColor() const |
- 34 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
Дополнительные унаследованные члены
- 1 публичный слот, унаследованный от QObject
- 1 публичная переменная, унаследованная от QObject
- 10 статических публичных членов, унаследованных от QObject
- 9 защищенных функций, унаследованных от QObject
- 2 защищенные переменные, унаследованные от QObject
Подробное описание
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. |
перечисление 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/archives/qt-5.11/q3dtheme.html