Класс QLegend
Класс QLegend отображает легенду графика. Подробнее...
| Заголовок: | #include <QLegend> |
| Создается из: | Легенда |
| Наследует от: | QGraphicsWidget |
Открытые типы
| перечисление | MarkerShape { MarkerShapeDefault, MarkerShapeRectangle, MarkerShapeCircle, MarkerShapeRotatedRectangle, MarkerShapeTriangle, …, MarkerShapeFromSeries } |
Свойства
|
|
Открытые функции
| виртуальный | ~QLegend() |
| Qt::Alignment | alignment() const |
| void | присоединитьКГрафику() |
| QColor | borderColor() |
| QBrush | заливка() const |
| QColor | цвет() |
| void | отсоединитьОтГрафика() |
| QFont | шрифт() const |
| bool | присоединенКГрафику() |
| bool | видимостьФона() const |
| bool | взаимодействие() const |
| QBrush | заливкаМетки() const |
| QColor | цветМетки() const |
| QLegend::MarkerShape | формаМаркера() const |
| QList<QLegendMarker *> | маркеры(QAbstractSeries *series = nullptr) const |
| QPen | линия() const |
| bool | обратныйПорядокМаркеров() |
| 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 | setInteractive(bool interactive) |
| void | setLabelBrush(const QBrush &brush) |
| void | setLabelColor(QColor color) |
| void | setMarkerShape(QLegend::MarkerShape shape) |
| void | setPen(const QPen &pen) |
| void | setReverseMarkers(bool reverseMarkers = true) |
| void | setShowToolTips(bool show) |
| bool | showToolTips() const |
Сигналы
| void | attachedToChartChanged(bool attached) |
| void | backgroundVisibleChanged(bool visible) |
| void | borderColorChanged(QColor color) |
| void | colorChanged(QColor color) |
| void | fontChanged(QFont font) |
| void | labelColorChanged(QColor color) |
| void | markerShapeChanged(QLegend::MarkerShape shape) |
| void | reverseMarkersChanged(bool reverseMarkers) |
| void | showToolTipsChanged(bool showToolTips) |
Подробное описание
Легенда — графический объект, отображающий легенду графика. Состояние легенды обновляется классом QChart при изменении рядов. По умолчанию, легенда присоединяется к графику, но её можно отсоединить, чтобы сделать её независимой от макета графика. Объекты легенды нельзя создавать или удалять, но на них можно сослаться через класс QChart.
См. также QChart.
Документация по типам членов
перечисление QLegend::MarkerShape
Это перечисление описывает форму, используемую при отрисовке элементов маркера легенды.
| Константа | Значение | Описание |
|---|---|---|
QLegend::MarkerShapeDefault |
0 |
Для маркера используется форма по умолчанию, определяемая QLegend. Это значение поддерживается только для отдельных элементов QLegendMarker. |
QLegend::MarkerShapeRectangle |
1 |
Используются прямоугольные маркеры. Размер маркера определяется размером шрифта. |
QLegend::MarkerShapeCircle |
2 |
Используются круговые маркеры. Размер маркера определяется размером шрифта. |
QLegend::MarkerShapeRotatedRectangle |
4 |
Используются маркеры в форме повернутого прямоугольника. Размер маркера определяется размером шрифта. |
QLegend::MarkerShapeTriangle |
5 |
Используются треугольные маркеры. Размер маркера определяется размером шрифта. |
QLegend::MarkerShapeStar |
6 |
Используются маркеры в форме звезды. Размер маркера определяется размером шрифта. |
QLegend::MarkerShapePentagon |
7 |
Используются маркеры в форме пятиугольника. Размер маркера определяется размером шрифта. |
QLegend::MarkerShapeFromSeries |
3 |
Форма маркера определяется серией. В случае серии точечной диаграммы маркер легенды выглядит как точечный маркер и имеет тот же размер, что и точка. В случае линейной или сплайн-серии маркер легенды выглядит как небольшой сегмент линии. Для других типов серий отображаются прямоугольные маркеры. Если для серии указан lightMarker, будет показан lightMarker, и его размер будет определяться размером маркера серии. |
См. также 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 |
| void | setFont(const QFont &font) |
Сигнал уведомления:
| void | fontChanged(QFont font) |
labelColor : QColor
Это свойство содержит цвет кисти, используемый для рисования меток.
Функции доступа:
| QColor | labelColor() const |
| void | setLabelColor(QColor color) |
Сигнал уведомления:
| void | labelColorChanged(QColor color) |
[since 5.9] markerShape : MarkerShape
Форма маркеров легенды по умолчанию. Значение по умолчанию — MarkerShapeRectangle.
Это свойство было добавлено в Qt 5.9.
Функции доступа:
| QLegend::MarkerShape | markerShape() const |
| void | setMarkerShape(QLegend::MarkerShape shape) |
Сигнал уведомления:
| void | markerShapeChanged(QLegend::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) |
Описание функций-членов
[signal, since 6.2] void QLegend::attachedToChartChanged(bool attached)
Этот сигнал испускается, когда легенда подключена к диаграмме или отсоединена от нее.
Эта функция была добавлена в Qt 6.2.
[signal] void QLegend::backgroundVisibleChanged(bool visible)
Этот сигнал испускается, когда видимость фона легенды изменяется на visible.
Примечание: Сигнал нотификации для свойства backgroundVisible.
[signal] void QLegend::borderColorChanged(QColor color)
Этот сигнал испускается, когда цвет границы фона легенды изменяется на color.
Примечание: Сигнал нотификации для свойства borderColor.
[signal] void QLegend::colorChanged(QColor color)
Этот сигнал испускается, когда цвет фона легенды изменяется на color.
Примечание: Сигнал нотификации для свойства color.
[signal] void QLegend::fontChanged(QFont font)
Этот сигнал испускается, когда шрифт маркеров легенды изменяется на font.
Примечание: Сигнал нотификации для свойства font.
[signal] void QLegend::labelColorChanged(QColor color)
Этот сигнал испускается, когда цвет кисти, используемой для рисования меток легенды, изменяется на color.
Примечание: Сигнал нотификации для свойства labelColor.
[signal] void QLegend::reverseMarkersChanged(bool reverseMarkers)
Этот сигнал испускается, когда использование обратного порядка для маркеров в легенде изменяется на reverseMarkers.
Примечание: Сигнал нотификации для свойства reverseMarkers.
[signal] void QLegend::showToolTipsChanged(bool showToolTips)
Этот сигнал испускается, когда видимость всплывающих подсказок изменяется на showToolTips.
Примечание: Сигнал нотификации для свойства showToolTips.
[virtual] QLegend::~QLegend()
Уничтожает объект легенды. Легенда всегда принадлежит QChart, поэтому приложение никогда не должно вызывать эту функцию.
void QLegend::attachToChart()
Присоединяет легенду к диаграмме. Диаграмма может скорректировать расположение легенды.
QBrush QLegend::brush() const
Возвращает кисть, используемую легендой.
См. также setBrush().
void QLegend::detachFromChart()
Отсоединяет легенду от диаграммы. Диаграмма больше не будет корректировать расположение легенды.
bool QLegend::isAttachedToChart()
Возвращает true, если легенда прикреплена к диаграмме.
bool QLegend::isBackgroundVisible() const
Возвращает видимость фона легенды.
Примечание: Функция-получатель для свойства backgroundVisible.
[since 6.2] bool QLegend::isInteractive() const
Возвращает, можно ли перетаскивать или изменять размер легенды с помощью мыши, когда она отсоединена.
Эта функция была добавлена в Qt 6.2.
См. также QLegend::setInteractive().
QBrush QLegend::labelBrush() const
Возвращает кисть, используемую для рисования меток.
См. также setLabelBrush().
QList<QLegendMarker *> QLegend::markers(QAbstractSeries *series = nullptr) const
Возвращает список маркеров в легенде. Список можно отфильтровать, указав series, для которого возвращаются маркеры.
QPen QLegend::pen() const
Возвращает перо, используемое легендой.
См. также setPen().
void QLegend::setBackgroundVisible(bool visible = true)
Устанавливает видимость фона легенды в visible.
Примечание: Функция-установщик для свойства backgroundVisible.
См. также isBackgroundVisible().
void QLegend::setBrush(const QBrush &brush)
Устанавливает brush, используемую для рисования фона легенды.
См. также brush().
[since 6.2] void QLegend::setInteractive(bool interactive)
Когда interactive равно true, и легенда отсоединена, легенду можно перемещать и изменять размер с помощью мыши аналогично окну.
Легенда автоматически прикрепится к краю диаграммы, перетащив её за пределы этого края. Двойной щелчок по прикреплённой легенде отсоединит её. По умолчанию это false.
Эта функция была добавлена в Qt 6.2.
См. также QLegend::isInteractive().
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().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qlegend.html
