Spec-Zone.ru › Qt 5.9

Класс QAbstractBarSeries

Класс QAbstractBarSeries — это абстрактный базовый класс для всех классов рядов столбцов. Подробнее...

Заголовок: #include <QAbstractBarSeries>
Создаётся: AbstractBarSeries
Наследуется от: QAbstractSeries
Наследуется:

QBarSeries, QHorizontalBarSeries, QHorizontalPercentBarSeries, QHorizontalStackedBarSeries, QPercentBarSeries и QStackedBarSeries

  • Список всех членов, включая унаследованные

Типы

перечисление LabelsPosition { LabelsCenter, LabelsInsideEnd, LabelsInsideBase, LabelsOutsideEnd }

Свойства

  • barWidth : qreal
  • count : const int
  • labelsAngle : qreal
  • labelsFormat : QString
  • labelsPosition : LabelsPosition
  • labelsVisible : bool
  • 5 свойств унаследовано от QAbstractSeries
  • 1 свойство унаследовано от QObject

Открытые функции

virtual ~QAbstractBarSeries()
bool append(QBarSet *set)
bool append(QList<QBarSet *> sets)
QList<QBarSet *> barSets() const
qreal barWidth() const
void clear()
int count() const
bool insert(int index, QBarSet *set)
bool isLabelsVisible() const
qreal labelsAngle() const
QString labelsFormat() const
QAbstractBarSeries::LabelsPosition labelsPosition() const
bool remove(QBarSet *set)
void setBarWidth(qreal width)
void setLabelsAngle(qreal angle)
void setLabelsFormat(const QString &format)
void setLabelsPosition(QAbstractBarSeries::LabelsPosition position)
void setLabelsVisible(bool visible = true)
bool take(QBarSet *set)
  • 15 открытых функций унаследовано от QAbstractSeries
  • 32 открытых функции унаследовано от QObject

Сигналы

void barsetsAdded(QList<QBarSet *> sets)
void barsetsRemoved(QList<QBarSet *> sets)
void clicked(int index, QBarSet *barset)
void countChanged()
void doubleClicked(int index, QBarSet *barset)
void hovered(bool status, int index, QBarSet *barset)
void labelsAngleChanged(qreal angle)
void labelsFormatChanged(const QString &format)
void labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)
void labelsVisibleChanged()
void pressed(int index, QBarSet *barset)
void released(int index, QBarSet *barset)
  • 4 сигнала унаследовано от QAbstractSeries
  • 2 сигнала унаследовано от QObject

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

  • 1 открытый слот унаследован от QObject
  • 11 статических открытых членов унаследовано от QObject
  • 9 защищённых функций унаследовано от QObject

Подробное описание

Класс QAbstractBarSeries — это абстрактный базовый класс для всех классов рядов столбцов.

В столбчатых диаграммах столбцы определяются как наборы столбцов, содержащие одно значение данных для каждой категории. Положение столбца определяется категорией, а его высота — значением данных. Ряды столбцов, содержащие несколько наборов столбцов, группируют вместе столбцы, относящиеся к одной категории. Способ отображения столбцов определяется подклассом этого класса, выбранным для создания столбчатой диаграммы.

Если для основной оси столбцов используется QValueAxis вместо QBarCategoryAxis, столбцы группируются вокруг индексного значения категории.

См. пример столбчатой диаграммы, чтобы узнать, как использовать класс QBarSeries для создания простой столбчатой диаграммы.

См. также QBarSet, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries и QHorizontalPercentBarSeries.

Документация типов членов

перечисление QAbstractBarSeries::LabelsPosition

Это перечисление описывает положение меток значений данных:

Постоянная Значение Описание
QAbstractBarSeries::LabelsCenter 0 Метка расположена в центре полосы.
QAbstractBarSeries::LabelsInsideEnd 1 Метка расположена внутри полосы вверху.
QAbstractBarSeries::LabelsInsideBase 2 Метка расположена внутри полосы внизу.
QAbstractBarSeries::LabelsOutsideEnd 3 Метка расположена за пределами полосы вверху.

Документация свойств

barWidth : qreal

Это свойство содержит ширину полос ряда.

Единицей ширины является единица оси x. Минимальная ширина полос равна нулю, а отрицательные значения обрабатываются как ноль. Установка ширины в ноль означает, что ширина полосы на экране составляет один пиксель независимо от масштаба оси x. Полосы с шириной больше нуля масштабируются с использованием масштаба оси x.

Примечание: При использовании с QBarSeries это значение задает ширину группы полос, а не отдельной полосы.

Функции доступа:

qreal barWidth() const
void setBarWidth(qreal width)

См. также QBarSeries.

count : const int

Это свойство содержит количество наборов полос в ряду полос.

Функции доступа:

int count() const

Сигнал уведомления:

void countChanged()

labelsAngle : qreal

Это свойство содержит угол меток значений в градусах.

Функции доступа:

qreal labelsAngle() const
void setLabelsAngle(qreal angle)

Сигнал уведомления:

void labelsAngleChanged(qreal angle)

labelsFormat : QString

Это свойство содержит формат, используемый для отображения меток в ряду полос.

QAbstractBarSeries поддерживает следующий тег формата:

@value Значение полосы

Например, следующее использование тегов формата создаст метки, которые показывают значение, за которым следует единица (u):

series->setLabelsFormat("@value u");

По умолчанию метки отображают значение полосы. Для ряда полос в процентах после значения добавляется %. Метки отображаются на области графика, а метки на краю области графика обрезаются. Если полосы находятся близко друг к другу, метки могут перекрываться.

Функции доступа:

QString labelsFormat() const
void setLabelsFormat(const QString &format)

Сигнал уведомления:

void labelsFormatChanged(const QString &format)

См. также labelsVisible и labelsPosition.

labelsPosition : LabelsPosition

Это свойство содержит положение меток значений.

Функции доступа:

QAbstractBarSeries::LabelsPosition labelsPosition() const
void setLabelsPosition(QAbstractBarSeries::LabelsPosition position)

Сигнал уведомления:

void labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)

См. также labelsVisible и labelsFormat.

labelsVisible : bool

Это свойство содержит видимость меток в ряду полос.

Функции доступа:

bool isLabelsVisible() const
void setLabelsVisible(bool visible = true)

Сигнал уведомления:

void labelsVisibleChanged()

Документация функций-членов

[virtual] QAbstractBarSeries::~QAbstractBarSeries()

Удаляет абстрактный ряд полос и наборы полос, которыми он владеет.

bool QAbstractBarSeries::append(QBarSet *set)

Добавляет набор полос, указанный параметром set, к ряду полос и принимает владение им. Если набор равен null или уже принадлежит ряду, он не будет добавлен. Возвращает true в случае успешного добавления.

bool QAbstractBarSeries::append(QList<QBarSet *> sets)

Добавляет список наборов полос, указанный параметром sets, к ряду полос и принимает владение наборами. Возвращает true если все наборы были успешно добавлены. Если любой из наборов равен null или был ранее добавлен в ряд, ничего не добавляется, и эта функция возвращает false. Если любой из наборов появляется в списке более одного раза, ничего не добавляется, и эта функция возвращает false.

QList<QBarSet *> QAbstractBarSeries::barSets() const

Возвращает список наборов полос в ряду полос. Сохраняет владение наборами полос.

qreal QAbstractBarSeries::barWidth() const

Возвращает ширину полос ряда.

Примечание: Функция-получатель для свойства barWidth.

См. также setBarWidth().

[signal] void QAbstractBarSeries::barsetsAdded(QList<QBarSet *> sets)

Этот сигнал испускается, когда наборы полос, заданные параметром sets, добавляются в ряд.

См. также append() и insert().

[signal] void QAbstractBarSeries::barsetsRemoved(QList<QBarSet *> sets)

Этот сигнал испускается, когда наборы полос, заданные параметром sets, удаляются из ряда.

См. также remove().

void QAbstractBarSeries::clear()

Удаляет все наборы полос из ряда и постоянно удаляет их.

[signal] void QAbstractBarSeries::clicked(int index, QBarSet *barset)

Этот сигнал испускается, когда пользователь щелкает по полосе, заданной параметром index, в наборе полос, заданном параметром barset.

int QAbstractBarSeries::count() const

Возвращает количество наборов полос в ряду полос.

Примечание: Функция-получатель для свойства count.

[signal] void QAbstractBarSeries::countChanged()

Этот сигнал испускается, когда количество наборов столбцов изменяется, например, при вызове append() или remove().

Примечание: Сигнал уведомления для свойства count.

[signal] void QAbstractBarSeries::doubleClicked(int index, QBarSet *barset)

Этот сигнал испускается, когда пользователь дважды щелкает по столбцу, указанному индексом index, в наборе столбцов, указанном barset.

[signal] void QAbstractBarSeries::hovered(bool status, int index, QBarSet *barset)

Этот сигнал испускается, когда курсор мыши наведён на столбец, указанный индексом index, в наборе столбцов, указанном barset. Когда курсор перемещается на столбец, status становится true, а когда курсор перемещается с столбца, он становится false.

bool QAbstractBarSeries::insert(int index, QBarSet *set)

Вставляет набор столбцов, указанный set, в серию в позиции, указанной index, и принимает владение набором. Если набор равен null или уже принадлежит серии, он не будет добавлен. Возвращает true если вставка выполнена успешно.

bool QAbstractBarSeries::isLabelsVisible() const

Возвращает видимость меток.

Примечание: Функция-геттер для свойства labelsVisible.

[signal] void QAbstractBarSeries::labelsAngleChanged(qreal angle)

Этот сигнал испускается, когда угол меток значений изменяется.

Примечание: Сигнал уведомления для свойства labelsAngle.

[signal] void QAbstractBarSeries::labelsFormatChanged(const QString &format)

Этот сигнал испускается, когда изменяется формат меток значений данных.

Примечание: Сигнал уведомления для свойства labelsFormat.

[signal] void QAbstractBarSeries::labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)

Этот сигнал испускается, когда меняется положение меток значений.

Примечание: Сигнал уведомления для свойства labelsPosition.

[signal] void QAbstractBarSeries::labelsVisibleChanged()

Этот сигнал испускается, когда меняется видимость меток.

Примечание: Сигнал уведомления для свойства labelsVisible.

См. также isLabelsVisible() и setLabelsVisible().

[signal] void QAbstractBarSeries::pressed(int index, QBarSet *barset)

Этот сигнал испускается, когда пользователь нажимает на столбец, указанный индексом index, в наборе столбцов, указанном barset, и удерживает нажатой кнопку мыши.

[signal] void QAbstractBarSeries::released(int index, QBarSet *barset)

Этот сигнал испускается, когда пользователь отпускает кнопку мыши на столбце, указанном индексом index, в наборе столбцов, указанном barset.

bool QAbstractBarSeries::remove(QBarSet *set)

Удаляет набор столбцов, указанный set, из серии и навсегда удаляет его, если удаление выполнено успешно. Возвращает true если набор был удалён.

void QAbstractBarSeries::setBarWidth(qreal width)

Устанавливает ширину столбцов серии в width.

Примечание: Функция-сеттер для свойства barWidth.

См. также barWidth().

void QAbstractBarSeries::setLabelsVisible(bool visible = true)

Устанавливает видимость меток в серии столбцов в visible.

Примечание: Функция-сеттер для свойства labelsVisible.

См. также isLabelsVisible().

bool QAbstractBarSeries::take(QBarSet *set)

Извлекает один набор set из серии. Не удаляет объект набора столбцов.

Примечание: Серия остаётся родительским объектом набора столбцов. Вы должны установить родительский объект, чтобы получить полное владение.

Возвращает true если операция извлечения выполнена успешно.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qabstractbarseries.html

Spec-Zone.ru

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