Класс QLegend
Класс QLegend отображает легенду графика. Подробнее...
| Заголовок: | #include <QLegend> |
| Создаётся из: | Legend |
| Наследует: | QGraphicsWidget |
Типы публичного доступа
| Перечисление | MarkerShape { MarkerShapeDefault, MarkerShapeRectangle, MarkerShapeCircle, MarkerShapeFromSeries } |
Свойства
|
|
- 14 свойств унаследовано от QGraphicsWidget
- 12 свойств унаследовано от QGraphicsObject
- 1 свойство унаследовано от QObject
Функции публичного доступа
| ~QLegend() | |
| Qt::Alignment | alignment() const |
| void | attachToChart() |
| QColor | borderColor() |
| QBrush | brush() const |
| QColor | color() |
| void | detachFromChart() |
| QFont | font() const |
| bool | isAttachedToChart() |
| bool | isBackgroundVisible() const |
| QBrush | labelBrush() const |
| QColor | labelColor() const |
| MarkerShape | markerShape() const |
| QList<QLegendMarker *> | markers(QAbstractSeries *series = Q_NULLPTR) const |
| QPen | pen() const |
| bool | reverseMarkers() |
| void | setAlignment(Qt::Alignment alignment) |
| void | setBackgroundVisible(bool visible = true) |
| void | setBorderColor(QColor color) |
| void | setBrush(const QBrush &brush) |
| void | setColor(QColor color) |
| void | setFont(const QFont &font) |
| void | setLabelBrush(const QBrush &brush) |
| void | setLabelColor(QColor color) |
| void | setMarkerShape(MarkerShape shape) |
| void | setPen(const QPen &pen) |
| void | setReverseMarkers(bool reverseMarkers = true) |
| void | setShowToolTips(bool show) |
| bool | showToolTips() const |
- 53 функции публичного доступа унаследованы от QGraphicsWidget
- 2 функции публичного доступа унаследованы от QGraphicsObject
- 35 функций публичного доступа унаследованы от QGraphicsLayoutItem
- 32 функции публичного доступа унаследованы от QObject
- 176 функций публичного доступа унаследованы от QGraphicsItem
Сигналы
| void | backgroundVisibleChanged(bool visible) |
| void | borderColorChanged(QColor color) |
| void | colorChanged(QColor color) |
| void | fontChanged(QFont font) |
| void | labelColorChanged(QColor color) |
| void | markerShapeChanged(MarkerShape shape) |
| void | reverseMarkersChanged(bool reverseMarkers) |
| void | showToolTipsChanged(bool showToolTips) |
- 1 сигнал унаследован от QGraphicsWidget
- 9 сигналов унаследовано от QGraphicsObject
- 2 сигнала унаследовано от QObject
Дополнительные унаследованные члены
- 1 слот публичного доступа унаследован от QGraphicsWidget
- 1 слот публичного доступа унаследован от QObject
- 1 статический публичный член унаследован от QGraphicsWidget
- 11 статических публичных членов унаследовано от QObject
- 2 статических публичных члена унаследовано от QGraphicsItem
- 24 защищенных функции унаследовано от QGraphicsWidget
- 1 защищенная функция унаследовано от QGraphicsObject
- 3 защищенных функции унаследовано от QGraphicsLayoutItem
- 9 защищенных функций унаследовано от QObject
- 24 защищенных функции унаследовано от QGraphicsItem
- 1 защищенный слот унаследован от QGraphicsObject
Подробное описание
Класс QLegend отображает легенду графика.
Легенда — это графический объект, отображающий легенду диаграммы. Состояние легенды обновляется классом QChart при изменении рядов. По умолчанию легенда прикреплена к диаграмме, но её можно отсоединить, чтобы сделать её независимой от макета диаграммы. Объекты легенды не могут быть созданы или удалены, но к ним можно обратиться через класс QChart.
См. также QChart.
Документация типов членов
enum QLegend::MarkerShape
Этот перечисление описывает форму, используемую при отрисовке элементов маркера легенды.
| Константа | Значение | Описание |
|---|---|---|
QLegend::MarkerShapeDefault |
0 |
Для маркера используется форма по умолчанию, определяемая классом QLegend. Это значение поддерживается только для отдельных элементов QLegendMarker. |
QLegend::MarkerShapeRectangle |
1 |
Используются прямоугольные маркеры. Размер маркера определяется размером шрифта. |
QLegend::MarkerShapeCircle |
2 |
Используются круглые маркеры. Размер маркера определяется размером шрифта. |
QLegend::MarkerShapeFromSeries |
3 |
Форма маркера определяется рядом. В случае ряда точечных диаграмм маркер легенды представляет собой точку разброса и имеет тот же размер, что и точка. В случае линейных или сплайн-рядов маркер легенды представляет собой небольшой отрезок линии. Для других типов рядов отображаются прямоугольные маркеры. |
См. также markerShape.
Документация свойств
alignment : Qt::Alignment
Как легенда выравнивается по отношению к графику.
Может быть Qt::AlignTop, Qt::AlignBottom, Qt::AlignLeft, Qt::AlignRight. Если установлено более одного флага, результат неопределён.
Функции доступа:
| Qt::Alignment | alignment() const |
| void | setAlignment(Qt::Alignment alignment) |
backgroundVisible : bool
Это свойство определяет, виден ли фон легенды.
Функции доступа:
| bool | isBackgroundVisible() const |
| void | setBackgroundVisible(bool visible = true) |
Сигнал уведомления:
| void | backgroundVisibleChanged(bool visible) |
borderColor : QColor
Это свойство содержит цвет линии легенды.
Функции доступа:
| QColor | borderColor() |
| void | setBorderColor(QColor color) |
Сигнал уведомления:
| void | borderColorChanged(QColor color) |
color : QColor
Это свойство содержит цвет фона (заливки) легенды.
Если изменить цвет легенды, стиль заливки легенды устанавливается в Qt::SolidPattern.
Функции доступа:
| QColor | color() |
| void | setColor(QColor color) |
Сигнал уведомления:
| void | colorChanged(QColor color) |
font : QFont
Это свойство содержит шрифт маркеров, используемых легендой.
Функции доступа:
| QFont | font() const |
| QFont | font() const |
| void | setFont(const QFont &font) |
| void | setFont(const QFont &font) |
Сигнал уведомления:
| void | fontChanged(QFont font) |
labelColor : QColor
Это свойство содержит цвет заливки, используемой для рисования меток.
Функции доступа:
| QColor | labelColor() const |
| void | setLabelColor(QColor color) |
Сигнал уведомления:
| void | labelColorChanged(QColor color) |
markerShape : MarkerShape
Указанная форма маркеров легенды. Значение по умолчанию - MarkerShapeRectangle.
Это свойство было добавлено в Qt 5.9.
Функции доступа:
| MarkerShape | markerShape() const |
| void | setMarkerShape(MarkerShape shape) |
Сигнал уведомления:
| void | markerShapeChanged(MarkerShape shape) |
reverseMarkers : bool
Это свойство определяет, используется ли обратный порядок маркеров в легенде.
Это свойство устанавливается по умолчанию в false.
Функции доступа:
| bool | reverseMarkers() |
| void | setReverseMarkers(bool reverseMarkers = true) |
Сигнал уведомления:
| void | reverseMarkersChanged(bool reverseMarkers) |
showToolTips : bool
Это свойство определяет, отображаются ли всплывающие подсказки при обрезке текста.
Это свойство установлено по умолчанию в false.
Функции доступа:
| bool | showToolTips() const |
| void | setShowToolTips(bool show) |
Сигнал уведомления:
| void | showToolTipsChanged(bool showToolTips) |
Документация функций-членов
QLegend::~QLegend()
Уничтожает объект легенды. Легенда всегда принадлежит QChart, поэтому приложение никогда не должно вызывать эту функцию.
void QLegend::attachToChart()
Присоединяет легенду к графику. График может изменить расположение легенды.
[signal] void QLegend::backgroundVisibleChanged(bool visible)
Этот сигнал излучается, когда видимость фона легенды изменяется на видимый.
Примечание: Сигнал уведомления для свойства backgroundVisible.
[signal] void QLegend::borderColorChanged(QColor color)
Этот сигнал излучается, когда цвет границы фона легенды изменяется на color.
Примечание: Сигнал уведомления для свойства borderColor.
QBrush QLegend::brush() const
Возвращает кисть, используемую легендой.
См. также setBrush().
[signal] void QLegend::colorChanged(QColor color)
Этот сигнал излучается, когда цвет фона легенды изменяется на color.
Примечание: Сигнал уведомления для свойства color.
void QLegend::detachFromChart()
Отсоединяет легенду от графика. График больше не будет изменять расположение легенды.
[signal] void QLegend::fontChanged(QFont font)
Этот сигнал излучается, когда шрифт маркеров легенды изменяется на font.
Примечание: Сигнал уведомления для свойства font.
bool QLegend::isAttachedToChart()
Возвращает true, если легенда прикреплена к графику.
bool QLegend::isBackgroundVisible() const
Возвращает видимость фона легенды.
Примечание: Функция-получатель для свойства backgroundVisible.
QBrush QLegend::labelBrush() const
Возвращает кисть, используемую для рисования меток.
См. также setLabelBrush().
[signal] void QLegend::labelColorChanged(QColor color)
Этот сигнал излучается, когда цвет кисти, используемой для рисования меток легенды, изменяется на color.
Примечание: Сигнал уведомления для свойства labelColor.
QList<QLegendMarker *> QLegend::markers(QAbstractSeries *series = Q_NULLPTR) const
Возвращает список маркеров в легенде. Список можно отфильтровать, указав series, для которого возвращаются маркеры.
QPen QLegend::pen() const
Возвращает перо, используемое легендой.
См. также setPen().
[signal] void QLegend::reverseMarkersChanged(bool reverseMarkers)
Этот сигнал излучается, когда использование обратного порядка для маркеров в легенде изменяется на reverseMarkers.
Примечание: Сигнал уведомления для свойства reverseMarkers.
void QLegend::setBackgroundVisible(bool visible = true)
Устанавливает видимость фона легенды в visible.
Примечание: Функция-установщик для свойства backgroundVisible.
См. также isBackgroundVisible().
void QLegend::setBrush(const QBrush &brush)
Устанавливает brush, используемую для рисования фона легенды.
См. также brush().
void QLegend::setLabelBrush(const QBrush &brush)
Устанавливает кисть, используемую для рисования меток легенды, на brush.
См. также labelBrush().
void QLegend::setPen(const QPen &pen)
Устанавливает pen, используемую для рисования границ легенды.
См. также pen().
void QLegend::setShowToolTips(bool show)
Когда show равно true, метки легенды будут отображать всплывающую подсказку при наведении курсора, если сама метка отображается усечённой. Это false по умолчанию.
Примечание: Функция-установщик для свойства showToolTips.
См. также showToolTips().
bool QLegend::showToolTips() const
Возвращает, отображаются ли всплывающие подсказки для меток легенды, когда они усечены.
Примечание: Функция-получатель для свойства showToolTips.
См. также setShowToolTips().
[signal] void QLegend::showToolTipsChanged(bool showToolTips)
Этот сигнал излучается, когда видимость всплывающих подсказок изменяется на showToolTips.
Примечание: Сигнал уведомления для свойства showToolTips.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qlegend.html
