Класс QScatter3DSeries
Класс QScatter3DSeries представляет серию данных в 3D точечном графике. Подробнее...
| Заголовок: | #include <QScatter3DSeries> |
| С тех пор: | QtDataVisualization 1.0 |
| Инициализируется: | Scatter3DSeries |
| Наследует: | QAbstract3DSeries |
Свойства
- dataProxy : QScatterDataProxy*
- itemSize : float
- selectedItem : int
Открытые функции
| QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr) | |
| QScatter3DSeries(QObject *parent = nullptr) | |
| virtual | ~QScatter3DSeries() |
| QScatterDataProxy * | dataProxy() const |
| float | itemSize() const |
| int | selectedItem() const |
| void | setDataProxy(QScatterDataProxy *proxy) |
| void | setItemSize(float size) |
| void | setSelectedItem(int index) |
Сигналы
| void | dataProxyChanged(QScatterDataProxy *proxy) |
| void | itemSizeChanged(float size) |
| void | selectedItemChanged(int index) |
Статические открытые члены
| int | invalidSelectionIndex() |
Подробное описание
Этот класс управляет визуальными элементами, специфичными для серии, а также данными серии (через прокси-сервер данных).
Если для серии явно не задан прокси-сервер данных, серия создает прокси-сервер по умолчанию. Установка другого прокси-сервера приведет к уничтожению существующего прокси-сервера и всех данных, добавленных к нему.
QScatter3DSeries поддерживает следующие теги формата для QAbstract3DSeries::setItemLabelFormat():
| @xTitle | Название с оси x |
| @yTitle | Название с оси y |
| @zTitle | Название с оси z |
| @xLabel | Значение элемента, отформатированное в соответствии с форматом оси x. Для получения дополнительной информации см. QValue3DAxis::setLabelFormat(). |
| @yLabel | Значение элемента, отформатированное в соответствии с форматом оси y. Для получения дополнительной информации см. QValue3DAxis::setLabelFormat(). |
| @zLabel | Значение элемента, отформатированное в соответствии с форматом оси z. Для получения дополнительной информации см. QValue3DAxis::setLabelFormat(). |
| @seriesName | Имя серии |
Например:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f")); См. также Обработка данных Qt Data Visualization.
Документация по свойствам
dataProxy : QScatterDataProxy*
Это свойство содержит активный прокси-сервер данных.
Функции доступа:
| QScatterDataProxy * | dataProxy() const |
| void | setDataProxy(QScatterDataProxy *proxy) |
Сигнал уведомления:
| void | dataProxyChanged(QScatterDataProxy *proxy) |
itemSize : float
Размер элемента для серии.
Размер должен быть между 0.0f и 1.0f. Установка размера в 0.0f приводит к автоматическому масштабированию размера элемента на основе общего количества элементов во всех сериях для графика.
Значение по умолчанию — 0.0f.
Функции доступа:
| float | itemSize() const |
| void | setItemSize(float size) |
Сигнал уведомления:
| void | itemSizeChanged(float size) |
selectedItem : int
Это свойство содержит элемент, выбранный в серии.
Функции доступа:
| int | selectedItem() const |
| void | setSelectedItem(int index) |
Сигнал уведомления:
| void | selectedItemChanged(int index) |
Документация по функциям-членам
QScatter3DSeries::QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr)
Создает серию 3D точек с прокси-сервером данных dataProxy и родителем parent.
QScatter3DSeries::QScatter3DSeries(QObject *parent = nullptr)
Создает серию 3D точек с родителем parent.
[virtual] QScatter3DSeries::~QScatter3DSeries()
Удаляет серию 3D точек.
[static] int QScatter3DSeries::invalidSelectionIndex()
Возвращает недопустимый индекс для выбора. Этот индекс устанавливается в свойство selectedItem, чтобы очистить выбор из этой серии.
См. также QAbstract3DGraph::clearSelection().
void QScatter3DSeries::setDataProxy(QScatterDataProxy *proxy)
Устанавливает активный прокси-сервер данных для серии на proxy. Серия принимает на себя владение любым установленным для неё прокси-сервером и удаляет любой ранее установленный прокси-сервер при добавлении нового. Аргумент proxy не может быть нулевым или быть назначенным другой серии.
Примечание: Функция-установщик для свойства dataProxy.
См. также dataProxy().
void QScatter3DSeries::setSelectedItem(int index)
Выбирает элемент с индексом index в массиве данных серии. Одновременно можно выбрать только один элемент.
Чтобы очистить выбор из этой серии, используется invalidSelectionIndex() в качестве index. Если эта серия добавлена в график, график может скорректировать выбор в соответствии с взаимодействием пользователя или если он становится недействительным. Выбор элемента в другой добавленной серии также очистит выбор.
Удаление или вставка элементов в серию перед выбранным элементом приведет к корректировке выбора таким образом, что выбранным останется тот же элемент.
Примечание: Функция-установщик для свойства selectedItem.
См. также selectedItem() и QAbstract3DGraph::clearSelection().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qscatter3dseries.html
