QAbstract3DSeries Class
QAbstract3DSeries クラスは、すべてのデータ系列の基底クラスです。詳細...
| ヘッダー: | #include <QAbstract3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| バージョン: | QtDataVisualization 1.0 |
| QMLでの使用開始: | Abstract3DSeries |
| 継承元: | QObject |
| 継承元: | |
| ステータス: | 非推奨 |
このクラスは非推奨です。新しいコードでの使用は強く推奨しません。
パブリック型
| enum | Mesh { MeshUserDefined, MeshBar, MeshCube, MeshPyramid, MeshCone, …, MeshPoint } |
| enum | SeriesType { SeriesTypeNone, SeriesTypeBar, SeriesTypeScatter, SeriesTypeSurface } |
プロパティ
|
|
パブリック関数
| virtual | ~QAbstract3DSeries() |
| QColor | baseColor() const |
| QLinearGradient | baseGradient() const |
| Q3DTheme::ColorStyle | colorStyle() const |
| bool | isItemLabelVisible() const |
| bool | isMeshSmooth() const |
| bool | isVisible() const |
| QString | itemLabel() const |
| QString | itemLabelFormat() const |
| QAbstract3DSeries::Mesh | mesh() const |
| QQuaternion | meshRotation() const |
| QColor | multiHighlightColor() const |
| QLinearGradient | multiHighlightGradient() const |
| QString | name() const |
| void | setBaseColor(const QColor &color) |
| void | setBaseGradient(const QLinearGradient &gradient) |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
| void | setItemLabelFormat(const QString &format) |
| void | setItemLabelVisible(bool visible) |
| void | setMesh(QAbstract3DSeries::Mesh mesh) |
| void | setMeshAxisAndAngle(const QVector3D &axis, float angle) |
| void | setMeshRotation(const QQuaternion &rotation) |
| void | setMeshSmooth(bool enable) |
| void | setMultiHighlightColor(const QColor &color) |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
| void | setName(const QString &name) |
| void | setSingleHighlightColor(const QColor &color) |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
| void | setUserDefinedMesh(const QString &fileName) |
| void | setVisible(bool visible) |
| QColor | singleHighlightColor() const |
| QLinearGradient | singleHighlightGradient() const |
| QAbstract3DSeries::SeriesType | type() const |
| QString | userDefinedMesh() const |
シグナル
| void | baseColorChanged(const QColor &color) |
| void | baseGradientChanged(const QLinearGradient &gradient) |
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
| void | itemLabelChanged(const QString &label) |
| void | itemLabelFormatChanged(const QString &format) |
| void | itemLabelVisibilityChanged(bool visible) |
| void | meshChanged(QAbstract3DSeries::Mesh mesh) |
| void | meshRotationChanged(const QQuaternion &rotation) |
| void | meshSmoothChanged(bool enabled) |
| void | multiHighlightColorChanged(const QColor &color) |
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
| void | nameChanged(const QString &name) |
| void | singleHighlightColorChanged(const QColor &color) |
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
| void | userDefinedMeshChanged(const QString &fileName) |
| void | visibilityChanged(bool visible) |
詳細な説明
サポートされている各シリーズ・タイプには、継承されたクラスが用意されています：QBar3DSeries 、QScatter3DSeries 、およびQSurface3DSeries 。
詳細については、「Qt Data Visualization データ処理」を参照してください。
メンバ型のドキュメント
enum QAbstract3DSeries::Mesh
定義済みのメッシュタイプ。すべてのスタイルが、すべての可視化タイプで使用できるわけではありません。
| 定数 | 値 | 説明 |
|---|---|---|
QAbstract3DSeries::MeshUserDefined | 0 | ユーザー定義のメッシュ。QAbstract3DSeries::userDefinedMesh プロパティで設定します。 |
QAbstract3DSeries::MeshBar | 1 | 基本的な長方形の棒。 |
QAbstract3DSeries::MeshCube | 2 | 基本的な立方体。 |
QAbstract3DSeries::MeshPyramid | 3 | 四面体のピラミッド。 |
QAbstract3DSeries::MeshCone | 4 | 基本的な円錐。 |
QAbstract3DSeries::MeshCylinder | 5 | 基本的な円柱。 |
QAbstract3DSeries::MeshBevelBar | 6 | わずかに面取り（丸み）のある長方体の棒。 |
QAbstract3DSeries::MeshBevelCube | 7 | わずかに面取り（丸み）が施された立方体。 |
QAbstract3DSeries::MeshSphere | 8 | 球体。 |
QAbstract3DSeries::MeshMinimal | 9 | 最小限の3Dメッシュ：三角錐。Q3DScatterでのみ使用可能です。 |
QAbstract3DSeries::MeshArrow | 10 | 上向きの矢印。 |
QAbstract3DSeries::MeshPoint | 11 | 2Dの点。Q3DScatterでのみ使用可能です。このスタイルでは、影の影響を受けません。カラースタイル「Q3DTheme::ColorStyleObjectGradient 」は、このスタイルではサポートされていません。 |
enum QAbstract3DSeries::SeriesType
シリーズの種類。
| 定数 | 値 | 説明 |
|---|---|---|
QAbstract3DSeries::SeriesTypeNone | 0 | シリーズタイプなし。 |
QAbstract3DSeries::SeriesTypeBar | 1 | Q3DBars のシリーズタイプ。 |
QAbstract3DSeries::SeriesTypeScatter | 2 | Q3DScatter の系列タイプ。 |
QAbstract3DSeries::SeriesTypeSurface | 4 | Q3DSurface のシリーズタイプ。 |
プロパティのドキュメント
baseColor : QColor
このプロパティは、シリーズの基調色を保持します。
アクセス関数：
| QColor | baseColor() const |
| void | setBaseColor(const QColor &color) |
通知シグナル:
| void | baseColorChanged(const QColor &color) |
関連項目: colorStyle およびQ3DTheme::baseColors 。
baseGradient : QLinearGradient
このプロパティは、シリーズの基本グラデーションを保持します。
アクセス関数：
| QLinearGradient | baseGradient() const |
| void | setBaseGradient(const QLinearGradient &gradient) |
通知シグナル:
| void | baseGradientChanged(const QLinearGradient &gradient) |
関連項目: colorStyle およびQ3DTheme::baseGradients 。
colorStyle : Q3DTheme::ColorStyle
このプロパティは、系列の色スタイルを保持します。
アクセス関数：
| Q3DTheme::ColorStyle | colorStyle() const |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
通知シグナル:
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
関連項目: ` Q3DTheme::ColorStyle`。
[read-only, since QtDataVisualization 1.1] itemLabel : QString
このプロパティには、書式設定された項目のラベルが格納されます。
選択された項目がない場合、または選択された項目が表示されていない場合は、空の文字列を返します。
この列挙型は、QtDataVisualization 1.1 で導入されました。
アクセス関数:
| QString | itemLabel() const |
通知シグナル:
| void | itemLabelChanged(const QString &label) |
itemLabelFormatも参照してください 。
itemLabelFormat : QString
このプロパティは、このシリーズ内のデータ項目のラベル形式を保持します。
このフォーマットは、項目が選択された場合など、単一の項目ラベルに使用されます。フォーマットの解釈方法は、シリーズの種類（QBar3DSeries、QScatter3DSeries、QSurface3DSeries）によって異なります。
アクセス関数：
| QString | itemLabelFormat() const |
| void | setItemLabelFormat(const QString &format) |
通知シグナル：
| void | itemLabelFormatChanged(const QString &format) |
[since QtDataVisualization 1.1] itemLabelVisible : bool
このプロパティは、グラフ内の項目ラベルの表示設定を指定します。
true の場合、アイテムラベルはグラフ内にフローティングラベルとして描画されます。それ以外の場合は、アイテムラベルは描画されません。外部コントロールにアイテムラベルを表示するには、このプロパティをfalse に設定します。デフォルトはtrue です。
この列挙型は、QtDataVisualization 1.1で導入されました。
アクセス関数:
| bool | isItemLabelVisible() const |
| void | setItemLabelVisible(bool visible) |
通知シグナル:
| void | itemLabelVisibilityChanged(bool visible) |
関連項目： itemLabelFormat およびitemLabel 。
mesh : Mesh
このプロパティには、シリーズに含まれるアイテムのメッシュが格納されます。
QSurface3DSeries の場合、このプロパティには選択ポインタが格納されます。
メッシュがMeshUserDefined である場合、アイテムを正しくレンダリングするには、userDefinedMesh プロパティも設定する必要があります。デフォルト値はグラフの種類によって異なります。
アクセス関数：
| QAbstract3DSeries::Mesh | mesh() const |
| void | setMesh(QAbstract3DSeries::Mesh mesh) |
Notifierシグナル:
| void | meshChanged(QAbstract3DSeries::Mesh mesh) |
meshRotation : QQuaternion
このプロパティには、シリーズのすべてのアイテムに適用されるメッシュの回転が格納されます。
回転は正規化されたQQuaternion で指定する必要があります。アイテムごとの回転をサポートするシリーズタイプの場合、各アイテムの回転は掛け合わされます。QBar3DSeriesは、y軸を中心としない回転を無視します。QSurface3DSeriesは、選択ポインタにのみ回転を適用します。デフォルトでは回転は適用されません。
アクセス関数：
| QQuaternion | meshRotation() const |
| void | setMeshRotation(const QQuaternion &rotation) |
通知シグナル：
| void | meshRotationChanged(const QQuaternion &rotation) |
meshSmooth : bool
このプロパティは、事前定義されたメッシュのスムース版を使用するかどうかを指定します。
true の場合、mesh プロパティで設定されたスムース版が使用されます。このプロパティは、meshがMeshUserDefined に設定されている場合に使用されるカスタムメッシュには影響しません。デフォルトはfalse です。
アクセス関数：
| bool | isMeshSmooth() const |
| void | setMeshSmooth(bool enable) |
通知シグナル：
| void | meshSmoothChanged(bool enabled) |
multiHighlightColor : QColor
このプロパティは、シリーズの複数項目のハイライト色を指定します。
アクセス関数：
| QColor | multiHighlightColor() const |
| void | setMultiHighlightColor(const QColor &color) |
通知シグナル：
| void | multiHighlightColorChanged(const QColor &color) |
関連項目: colorStyle およびQ3DTheme::multiHighlightColor 。
multiHighlightGradient : QLinearGradient
このプロパティは、系列の複数の項目を強調表示するためのグラデーションを保持します。
アクセス関数：
| QLinearGradient | multiHighlightGradient() const |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
通知シグナル:
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
関連項目: colorStyle およびQ3DTheme::multiHighlightGradient 。
name : QString
このプロパティには、シリーズ名が格納されます。
シリーズ名は、タグ「@seriesName 」を使用して、項目ラベルの形式で利用できます。
アクセス関数：
| QString | name() const |
| void | setName(const QString &name) |
通知信号:
| void | nameChanged(const QString &name) |
「itemLabelFormat」も参照してください 。
singleHighlightColor : QColor
このプロパティは、系列の単一項目のハイライト色を指定します。
アクセス関数：
| QColor | singleHighlightColor() const |
| void | setSingleHighlightColor(const QColor &color) |
通知シグナル:
| void | singleHighlightColorChanged(const QColor &color) |
関連項目: colorStyle およびQ3DTheme::singleHighlightColor 。
singleHighlightGradient : QLinearGradient
このプロパティは、系列の単一項目のハイライト用グラデーションを保持します。
アクセス関数：
| QLinearGradient | singleHighlightGradient() const |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
通知シグナル:
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
関連項目: colorStyle およびQ3DTheme::singleHighlightGradient 。
[read-only] type : const SeriesType
このプロパティは、系列の型を保持します。
アクセス関数：
| QAbstract3DSeries::SeriesType | type() const |
userDefinedMesh : QString
このプロパティには、オブジェクト用のユーザー定義カスタムメッシュのファイル名が格納されます。
このカスタムメッシュは、mesh がMeshUserDefined に設定されている場合に使用されます。
注：ファイルはWavefront OBJ形式であり、頂点、法線、UV情報を含んでいる必要があります。また、三角形構成である必要があります。
アクセス関数：
| QString | userDefinedMesh() const |
| void | setUserDefinedMesh(const QString &fileName) |
通知シグナル：
| void | userDefinedMeshChanged(const QString &fileName) |
visible : bool
このプロパティは、シリーズの表示設定を保持します。
このプロパティがfalse の場合、シリーズは描画されません。デフォルトはtrue です。
アクセス関数:
| bool | isVisible() const |
| void | setVisible(bool visible) |
通知シグナル:
| void | visibilityChanged(bool visible) |
メンバ関数のドキュメント
[virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()
「abstract 3D」シリーズを削除します。
[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(const QVector3D &axis, float angle)
axis およびangle からメッシュ回転クォータニオンを生成するための便利関数です。
注：この関数は 、メタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
meshRotationも参照してください 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
