QBar3DSeries Class
QBar3DSeriesクラスは、3D棒グラフのデータ系列を表します。詳細...
| Header: | #include <QBar3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | Bar3DSeries |
| Inherits: | QAbstract3DSeries |
- 継承メンバを含む全メンバ一覧
- QBar3DSeries はQt Graphs C++ Classes for 3D に含まれます。
プロパティ
|
|
パブリック関数
| QBar3DSeries(QObject *parent = nullptr) | |
| QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QBar3DSeries() override |
| void | clearArray() |
| void | clearRow(qsizetype rowIndex) |
| QStringList | columnLabels() const |
| QBarDataArray | dataArray() && |
| const QBarDataArray & | dataArray() const & |
| QBarDataProxy * | dataProxy() const |
| float | meshAngle() const |
| QList<QColor> | rowColors() const |
| QStringList | rowLabels() const |
| QPoint | selectedBar() const |
| void | setColumnLabels(const QStringList &labels) |
| void | setDataArray(const QBarDataArray &newDataArray) |
| void | setDataProxy(QBarDataProxy *proxy) |
| void | setMeshAngle(float angle) |
| void | setRowColors(const QList<QColor> &colors) |
| void | setRowLabels(const QStringList &labels) |
| void | setSelectedBar(QPoint position) |
シグナル
| void | columnLabelsChanged() |
| void | dataArrayChanged(const QBarDataArray &array) |
| void | dataProxyChanged(QBarDataProxy *proxy) |
| void | meshAngleChanged(float angle) |
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
| void | rowLabelsChanged() |
| void | selectedBarChanged(QPoint position) |
静的パブリックメンバー
| QPoint | invalidSelectionPosition() |
詳細説明
このクラスは、シリーズ固有のビジュアル要素と、（データプロキシを介した）シリーズデータを管理します。
プロキシとシリーズの関係については、いくつかの重要なポイントを強調することが重要です。このコンテキストでは、データは系列に格納され、ユーザは系列を通してデータセットにアクセスできる。この系列はプロキシオブジェクトによって制御または表現される。したがって、このプロキシを使って、データに対するさまざまな操作を管理し、実際のデータセットを更新することができる。ただし、データセットを編集するには、このプロキシに関連付けられた系列を作成する必要がある。
シリーズに明示的にデータプロキシが設定されていない場合、シリーズはデフォルトのプロキシを作成する。別のプロキシを設定すると、既存のプロキシとシリーズに追加されたすべてのデータが破棄されます。
QBar3DSeries はQAbstract3DSeries::setItemLabelFormat() で以下のフォーマットタグをサポートしています：
| 行タイトル | 行軸からのタイトル |
| colTitle | 列軸からのタイトル |
| 値軸からのタイトル | 値軸からのタイトル |
| 行インデックス | 可視行インデックス。グラフロケールでローカライズ。 |
| colIdx | 可視の列インデックス。グラフロケールを使用してローカライズされます。 |
| 行ラベル | 行軸のラベル。 |
| colLabel | 列軸のラベル |
| 値ラベル | グラフに付属する値軸の書式を使用してフォーマットされた項目値。詳細については、QValue3DAxis::labelFormat を参照してください。 |
| シリーズ名 | 系列の名前。 |
| <フォーマット仕様 | 指定された形式での項目値。QValue3DAxis::labelFormat と同じルールを使用してフォーマットされます。 |
例えば、次のようになります：
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
Qt Graphs Data Handling with 3DおよびQ3DGraphsWidgetItem::localeも参照してください 。
プロパティ ドキュメント
columnLabels : QStringList
このプロパティは、配列のオプションの列ラベルを保持します。
この配列のインデックスは、行の列インデックスと一致します。リストが最長の行よりも短い場合、すべての列はラベルを取得しません。
アクセス関数：
| QStringList | columnLabels() const |
| void | setColumnLabels(const QStringList &labels) |
通知シグナル：
| void | columnLabelsChanged() |
dataArray : QBarDataArray
系列データ配列。
データ配列の参照を保持する。
dataArrayChanged シグナルは、newDataArray が前回と同じでない限り、データ配列が設定されたときに発せられる。
注： dataArrayに関して何かを行う前に、関連するプロキシに対してシリーズを作成する必要がある。
アクセス関数：
| const QBarDataArray & | dataArray() const & |
| QBarDataArray | dataArray() && |
| void | setDataArray(const QBarDataArray &newDataArray) |
通知シグナル：
| void | dataArrayChanged(const QBarDataArray &array) |
clearRow(qsizetype rowIndex) およびclearArray()も参照のこと 。
dataProxy : QBarDataProxy*
このプロパティは、アクティブなデータプロキシを保持する。
シリーズは、それに設定されたプロキシの所有権を引き受け、新しいプロキシが追加されると、以前に設定されたプロキシを削除します。プロキシをNULLにしたり、他の系列に設定したりすることはできません。
アクセス関数：
| QBarDataProxy * | dataProxy() const |
| void | setDataProxy(QBarDataProxy *proxy) |
ノーティファイアシグナル：
| void | dataProxyChanged(QBarDataProxy *proxy) |
meshAngle : float
このプロパティは、シリーズの回転角度を度単位で保持する。
このプロパティを設定することは、以下の呼び出しと等価である：
setMeshRotation(QQuaternion::fromAxisAndAngle(0.0f, 1.0f, 0.0f, angle))
注： このプロパティを読み込む場合、浮動小数点精度を用いてQAbstract3DSeries::meshRotation の値から計算され、常に 0 度から 360 度までの値を返す。
アクセス関数：
| float | meshAngle() const |
| void | setMeshAngle(float angle) |
ノーティファイアシグナル：
| void | meshAngleChanged(float angle) |
QAbstract3DSeries::meshRotationも参照のこと 。
rowColors : QList<QColor>
このプロパティは、シリーズの行の色のリストを保持する。
このプロパティを使用して、シリーズの行を異なる色で着色することができる。このプロパティを使用するには、QGraphsTheme::ColorStyle をQGraphsTheme::ColorStyle::Uniform に設定する必要がある。
アクセス関数：
| QList<QColor> | rowColors() const |
| void | setRowColors(const QList<QColor> &colors) |
通知シグナル：
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
QGraphsTheme::ColorStyle::Uniformも参照のこと 。
rowLabels : QStringList
このプロパティは、配列のオプションの行ラベルを保持する。
この配列のインデックスは、データ配列の行インデックスと一致する。リストが行数より短い場合、すべての行にラベルは付与されません。
アクセス関数：
| QStringList | rowLabels() const |
| void | setRowLabels(const QStringList &labels) |
通知シグナル：
| void | rowLabelsChanged() |
selectedBar : QPoint
このプロパティは、選択されているシリーズのバーを保持します。
アクセス関数：
| QPoint | selectedBar() const |
| void | setSelectedBar(QPoint position) |
通知シグナル：
| void | selectedBarChanged(QPoint position) |
メンバ関数ドキュメント
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
親parent を持つバー 3D シリーズを構築する。
[explicit] QBar3DSeries::QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
データプロキシdataProxy と親parent を使用して、バー 3D シリーズを構築します。
[override virtual noexcept] QBar3DSeries::~QBar3DSeries()
バー 3D シリーズを削除します。
void QBar3DSeries::clearArray()
既存の配列をクリアします。
void QBar3DSeries::clearRow(qsizetype rowIndex)
指定されたrowIndex に従って、配列内の既存の行をクリアします。
[static] QPoint QBar3DSeries::invalidSelectionPosition()
無効な選択位置を返します。この位置をselectedBar プロパティに設定することで、このシリーズからの選択をクリアします。
Q3DGraphsWidgetItem::clearSelection()も参照してください 。
void QBar3DSeries::setSelectedBar(QPoint position)
このシリーズのデータ配列の行と列で指定されたposition 位置のバーを選択する。
一度に選択できるバーは 1 つだけです。
この系列から選択を解除するには、invalidSelectionPosition() をposition とする。
この系列がグラフに追加された場合、グラフはユーザーの操作に応じて、または無効となった場合に選択を調整することができる。追加された他の系列のバーを選択すると、選択範囲もクリアされる。
選択されたバーの行の前に系列から行を削除したり、系列に行を挿入したりすると、同じバーが選択されたままになるように選択が調整される。
注： selectedBar プロパティのセッター関数。
selectedBar() およびQ3DGraphsWidgetItem::clearSelection()も参照してください 。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
