Класс QLegend
Класс QLegend отображает легенду графика. Подробнее...
| Заголовок: | #include <QLegend> |
| Создается из: | Легенда |
| Наследует: | QGraphicsWidget |
Типы public
| Перечисление | MarkerShape { MarkerShapeDefault, MarkerShapeRectangle, MarkerShapeCircle, MarkerShapeFromSeries } |
Свойства
|
|
Public Функции
| virtual | ~QLegend() |
| Qt::Alignment | alignment() const |
| void | присоединитьКГрафику() |
| QColor | borderColor() |
| QBrush | brush() const |
| QColor | цвет() |
| void | отсоединитьОтГрафика() |
| QFont | шрифт() const |
| bool | присоединенКГрафику() |
| bool | видимостьФона() const |
| QBrush | кистьМетки() const |
| QColor | цветМетки() const |
| QLegend::MarkerShape | формаМаркера() const |
| QList<QLegendMarker *> | маркеры(QAbstractSeries *series = nullptr) const |
| QPen | pen() const |
| bool | обратныйПорядокМаркеров() |
| void | установитьВыравнивание(Qt::Alignment alignment) |
| void | установитьВидимостьФона(bool visible = true) |
| void | установитьЦветГраницы(QColor color) |
| void | установитьКисть(const QBrush &brush) |
| void | установитьЦвет(QColor color) |
| void | установитьШрифт(const QFont &font) |
| void | установитьКистьМетки(const QBrush &brush) |
| void | установитьЦветМетки(QColor color) |
| void | установитьФормуМаркера(QLegend::MarkerShape shape) |
| void | установитьПеро(const QPen &pen) |
| void | установитьОбратныйПорядокМаркеров(bool reverseMarkers = true) |
| void | установитьПоказыватьПодсказки(bool show) |
| bool | показыватьПодсказки() const |
Сигналы
| 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::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 |
| 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] 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.
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().
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.1/qlegend.html
