Spec-Zone.ru › Qt 5.12

Класс Q3DTheme

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

Заголовок: #include <Q3DTheme>
С момента: QtDataVisualization 1.0
Инициализируется: Theme3D
Наследует: QObject
  • Список всех членов, включая унаследованные
  • Устаревшие члены

Типы

Перечисление ColorStyle { ColorStyleUniform, ColorStyleObjectGradient, ColorStyleRangeGradient }
Перечисление Theme { ThemeQt, ThemePrimaryColors, ThemeDigia, ThemeStoneMoss, ..., ThemeUserDefined }

Свойства

  • ambientLightStrength : float
  • цвет фона : QColor
  • backgroundEnabled : bool
  • baseColors : QList<QColor>
  • baseGradients : QList<QLinearGradient>
  • стиль цвета : ColorStyle
  • шрифт : QFont
  • gridEnabled : bool
  • цвет линии сетки : QColor
  • highlightLightStrength : float
  • цвет фона метки : QColor
  • labelBackgroundEnabled : bool
  • labelBorderEnabled : bool
  • цвет текста метки : QColor
  • цвет света : QColor
  • сила света : float
  • цвет выделения нескольких объектов : QColor
  • градиент выделения нескольких объектов : QLinearGradient
  • цвет выделения одного объекта : QColor
  • градиент выделения одного объекта : QLinearGradient
  • тип : Theme
  • цвет окна : QColor
  • 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

Дополнительные унаследованные члены

  • 1 публичный слот унаследован от QObject
  • 9 защищённых функций унаследованы от 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.

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

Spec-Zone.ru

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