QAbstract3DSeries Class
QAbstract3DSeries クラスは、すべての 3D データ系列の基底クラスです。詳細...
| ヘッダー: | #include <QAbstract3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| QML内: | Abstract3DSeries |
| 継承元: | QObject |
| 継承元: |
- 継承されたメンバーを含むすべてのメンバーの一覧
- QAbstract3DSeriesは、Qt Graphs の3D用C++クラスの一部です。
パブリック型
| enum class | LightingMode { Shaded, Unshaded } |
| enum class | Mesh { UserDefined, Bar, Cube, Pyramid, Cone, …, Point } |
| enum class | SeriesType { None, Bar, Scatter, Surface } |
プロパティ
|
|
パブリック関数
| virtual | ~QAbstract3DSeries() override |
| QColor | baseColor() const |
| QLinearGradient | baseGradient() const |
| QGraphsTheme::ColorStyle | colorStyle() const |
| bool | isItemLabelVisible() const |
| bool | isMeshSmooth() const |
| bool | isVisible() const |
| QString | itemLabel() |
| QString | itemLabelFormat() const |
| QAbstract3DSeries::LightingMode | lightingMode() const |
| QAbstract3DSeries::Mesh | mesh() const |
| QQuaternion | meshRotation() const |
| QColor | multiHighlightColor() const |
| QLinearGradient | multiHighlightGradient() const |
| QString | name() const |
| void | setBaseColor(QColor color) |
| void | setBaseGradient(const QLinearGradient &gradient) |
| void | setColorStyle(QGraphsTheme::ColorStyle style) |
| void | setItemLabelFormat(const QString &format) |
| void | setItemLabelVisible(bool visible) |
| void | setLightingMode(QAbstract3DSeries::LightingMode lightingMode) |
| void | setMesh(QAbstract3DSeries::Mesh mesh) |
| void | setMeshAxisAndAngle(QVector3D axis, float angle) |
| void | setMeshRotation(const QQuaternion &rotation) |
| void | setMeshSmooth(bool enable) |
| void | setMultiHighlightColor(QColor color) |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
| void | setName(const QString &name) |
| void | setSingleHighlightColor(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(QColor color) |
| void | baseGradientChanged(const QLinearGradient &gradient) |
| void | colorStyleChanged(QGraphsTheme::ColorStyle style) |
| void | itemLabelChanged(const QString &label) |
| void | itemLabelFormatChanged(const QString &format) |
| void | itemLabelVisibleChanged(bool visible) |
| void | lightingModeChanged(QAbstract3DSeries::LightingMode lightingMode) |
| void | meshChanged(QAbstract3DSeries::Mesh mesh) |
| void | meshRotationChanged(const QQuaternion &rotation) |
| void | meshSmoothChanged(bool enabled) |
| void | multiHighlightColorChanged(QColor color) |
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
| void | nameChanged(const QString &name) |
| void | singleHighlightColorChanged(QColor color) |
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
| void | userDefinedMeshChanged(const QString &fileName) |
| void | visibleChanged(bool visible) |
詳細な説明
サポートされている各シリーズ型には、継承されたクラスが用意されています:QBar3DSeries 、QScatter3DSeries 、およびQSurface3DSeries です。
詳細については、「Qt Graphs 3D データ処理」を参照してください。
メンバ型のドキュメント
enum class QAbstract3DSeries::LightingMode
あらかじめ設定された照明モード
| 一定 | 値 | 説明 |
|---|---|---|
QAbstract3DSeries::LightingMode::Shaded | 0 | グラフはリアルタイムの照明変化に反応します |
QAbstract3DSeries::LightingMode::Unshaded | -1 | グラフはリアルタイムの照明に反応しません |
enum class QAbstract3DSeries::Mesh
定義済みのメッシュタイプ。すべてのスタイルが、すべてのグラフタイプで使用できるわけではありません。
| 定数 | 値 | 説明 |
|---|---|---|
QAbstract3DSeries::Mesh::UserDefined | 0 | ユーザー定義のメッシュ。QAbstract3DSeries::userDefinedMesh プロパティで設定します。 |
QAbstract3DSeries::Mesh::Bar | 1 | 基本的な長方形の棒グラフ。 |
QAbstract3DSeries::Mesh::Cube | 2 | 基本的な立方体。 |
QAbstract3DSeries::Mesh::Pyramid | 3 | 四面体のピラミッド。 |
QAbstract3DSeries::Mesh::Cone | 4 | 基本的な円錐。 |
QAbstract3DSeries::Mesh::Cylinder | 5 | 基本的な円柱。 |
QAbstract3DSeries::Mesh::BevelBar | 6 | わずかに面取り(丸み)のある長方体の棒。 |
QAbstract3DSeries::Mesh::BevelCube | 7 | わずかに面取り(丸み)が施された立方体。 |
QAbstract3DSeries::Mesh::Sphere | 8 | 球体。 |
QAbstract3DSeries::Mesh::Minimal | 9 | 最小限の3Dメッシュ:三角錐。Q3DScatterWidgetItem でのみ使用可能です。 |
QAbstract3DSeries::Mesh::Arrow | 10 | 上向きの矢印。 |
QAbstract3DSeries::Mesh::Point | 11 | 2Dの点。Q3DScatterWidgetItem でのみ使用可能です。このスタイルでは、影の影響を受けません。カラースタイル「QGraphsTheme::ColorStyle::ObjectGradient 」はこのスタイルではサポートされていません。 |
enum class QAbstract3DSeries::SeriesType
シリーズの種類。
| 定数 | 値 | 説明 |
|---|---|---|
QAbstract3DSeries::SeriesType::None | 0 | シリーズタイプなし。 |
QAbstract3DSeries::SeriesType::Bar | 1 | Q3DBarsWidgetItem のシリーズタイプ。 |
QAbstract3DSeries::SeriesType::Scatter | 2 | Q3DScatterWidgetItem のシリーズタイプ。 |
QAbstract3DSeries::SeriesType::Surface | 3 | Q3DSurfaceWidgetItem のシリーズタイプ。 |
プロパティのドキュメント
baseColor : QColor
このプロパティは、シリーズの基調色を指定します。
アクセス関数:
| QColor | baseColor() const |
| void | setBaseColor(QColor color) |
通知シグナル:
| void | baseColorChanged(QColor color) |
関連項目: colorStyle およびQGraphsTheme::seriesColors 。
baseGradient : QLinearGradient
このプロパティは、シリーズの基本グラデーションを保持します。
アクセス関数:
| QLinearGradient | baseGradient() const |
| void | setBaseGradient(const QLinearGradient &gradient) |
通知シグナル:
| void | baseGradientChanged(const QLinearGradient &gradient) |
関連項目: colorStyle およびQGraphsTheme::seriesGradients 。
colorStyle : QGraphsTheme::ColorStyle
このプロパティは、シリーズのカラースタイルを指定します。
アクセス関数:
| QGraphsTheme::ColorStyle | colorStyle() const |
| void | setColorStyle(QGraphsTheme::ColorStyle style) |
通知シグナル:
| void | colorStyleChanged(QGraphsTheme::ColorStyle style) |
関連項目: QGraphsTheme::ColorStyle 。
[read-only] itemLabel : QString
このプロパティには、書式設定された項目のラベルが格納されます。
選択された項目がない場合、または選択された項目が表示されていない場合は、空の文字列を返します。
アクセス関数:
| QString | itemLabel() |
通知シグナル:
| void | itemLabelChanged(const QString &label) |
関連項目: itemLabelFormat 。
itemLabelFormat : QString
このプロパティには、この系列のデータ項目のラベル形式が格納されます。
この書式は、たとえば項目が選択された際など、単一の項目ラベルに使用されます。書式の解釈方法は、系列の種類によって異なります。
アクセス関数:
| QString | itemLabelFormat() const |
| void | setItemLabelFormat(const QString &format) |
通知信号:
| void | itemLabelFormatChanged(const QString &format) |
関連項目: QBar3DSeries 、QScatter3DSeries 、およびQSurface3DSeries 。
itemLabelVisible : bool
このプロパティは、グラフ内の項目ラベルの表示設定を指定します。
true の場合、項目ラベルはグラフ内にフローティングラベルとして描画されます。それ以外の場合は、項目ラベルは描画されません。外部コントロールに項目ラベルを表示するには、このプロパティをfalse に設定します。デフォルトはtrue です。
アクセス関数:
| bool | isItemLabelVisible() const |
| void | setItemLabelVisible(bool visible) |
通知シグナル:
| void | itemLabelVisibleChanged(bool visible) |
「 itemLabelFormat 」および「itemLabel 」も参照してください 。
[since 6.10] lightingMode : QAbstract3DSeries::LightingMode
このプロパティは、シリーズの照明モードを保持します
この列挙型は Qt 6.10 で導入されました。
アクセス関数:
| QAbstract3DSeries::LightingMode | lightingMode() const |
| void | setLightingMode(QAbstract3DSeries::LightingMode lightingMode) |
通知シグナル:
| void | lightingModeChanged(QAbstract3DSeries::LightingMode lightingMode) |
関連項目: LightingMode 。
mesh : QAbstract3DSeries::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 プロパティで設定されたスムース版が使用されます。このプロパティは、メッシュがMeshUserDefinedに設定されている場合に使用されるカスタムメッシュには影響しません。デフォルトはfalse です。
アクセス関数:
| bool | isMeshSmooth() const |
| void | setMeshSmooth(bool enable) |
Notifierシグナル:
| void | meshSmoothChanged(bool enabled) |
multiHighlightColor : QColor
このプロパティは、シリーズ内の複数の項目のハイライト色を指定します。
アクセス関数:
| QColor | multiHighlightColor() const |
| void | setMultiHighlightColor(QColor color) |
通知シグナル:
| void | multiHighlightColorChanged(QColor color) |
関連項目: colorStyle およびQGraphsTheme::multiHighlightColor 。
multiHighlightGradient : QLinearGradient
このプロパティは、系列の複数の項目を強調表示するためのグラデーションを保持します。
アクセス関数:
| QLinearGradient | multiHighlightGradient() const |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
通知シグナル:
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
関連項目: colorStyle およびQGraphsTheme::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(QColor color) |
通知シグナル:
| void | singleHighlightColorChanged(QColor color) |
関連項目: colorStyle およびQGraphsTheme::singleHighlightColor 。
singleHighlightGradient : QLinearGradient
このプロパティは、系列の単一項目のハイライトグラデーションを保持します。
アクセス関数:
| QLinearGradient | singleHighlightGradient() const |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
通知シグナル:
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
関連項目: colorStyle およびQGraphsTheme::singleHighlightGradient 。
[read-only] type : const QAbstract3DSeries::SeriesType
このプロパティは、系列の型を保持します。
アクセス関数:
| QAbstract3DSeries::SeriesType | type() const |
userDefinedMesh : QString
このプロパティには、オブジェクト用のユーザー定義カスタムメッシュのファイル名が格納されます。
このカスタムメッシュは、mesh がMeshUserDefinedに設定されている場合に使用されます。
注:ファイルは 、QtQuick3D のメッシュ形式である必要があります。他の3Dモデル形式からメッシュを作成するには、balsam の変換ツールを使用してください。
アクセス関数:
| 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 | visibleChanged(bool visible) |
メンバ関数のドキュメント
[override virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()
「abstract 3D」シリーズを削除します。
[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(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.