QAbstract3DSeries Class

QAbstract3DSeries クラスは、すべての 3D データシリーズの基本クラスです。詳細...

Header: #include <QAbstract3DSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
In QML: Abstract3DSeries
Inherits: QObject
Inherited By:

QBar3DSeries, QScatter3DSeries, and QSurface3DSeries

パブリックタイプ

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::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 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 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 Data Handling with 3D を参照してください。

メンバタイプのドキュメント

enum class QAbstract3DSeries::Mesh

定義済みのメッシュタイプ。すべてのスタイルがすべてのグラフタイプで使用できるわけではありません。

定数説明
QAbstract3DSeries::Mesh::UserDefined0ユーザー定義メッシュ。QAbstract3DSeries::userDefinedMesh プロパティで設定。
QAbstract3DSeries::Mesh::Bar1基本的な長方形のバー。
QAbstract3DSeries::Mesh::Cube2基本立方体。
QAbstract3DSeries::Mesh::Pyramid3四角錐。
QAbstract3DSeries::Mesh::Cone4基本円錐。
QAbstract3DSeries::Mesh::Cylinder5基本円柱。
QAbstract3DSeries::Mesh::BevelBar6わずかに面取りされた(丸みを帯びた)長方形の棒。
QAbstract3DSeries::Mesh::BevelCube7わずかに面取りされた(丸みを帯びた)立方体。
QAbstract3DSeries::Mesh::Sphere8球体。
QAbstract3DSeries::Mesh::Minimal9最小の3Dメッシュ:三角錐。Q3DScatterWidgetItem でのみ使用可能。
QAbstract3DSeries::Mesh::Arrow10上向きの矢印。
QAbstract3DSeries::Mesh::Point112D点。Q3DScatterWidgetItem でのみ使用可能。影はこのスタイルに影響しません。カラースタイルQGraphsTheme::ColorStyle::ObjectGradient はこのスタイルではサポートされていません。

enum class QAbstract3DSeries::SeriesType

系列の種類。

定数説明
QAbstract3DSeries::SeriesType::None0シリーズタイプなし。
QAbstract3DSeries::SeriesType::Bar1Q3DBarsWidgetItem
QAbstract3DSeries::SeriesType::Scatter2Q3DScatterWidgetItem のシリーズタイプ。
QAbstract3DSeries::SeriesType::Surface3Q3DSurfaceWidgetItem のシリーズタイプ。

プロパティの説明

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 : const QString

このプロパティはフォーマットされた項目ラベルを保持する。

選択項目がない場合、または選択項目が表示されていない場合は、空文字列を返します。

アクセス関数:

QString itemLabel()

Notifier シグナル:

void itemLabelChanged(const QString &label)

itemLabelFormatも参照

itemLabelFormat : QString

このプロパティは、このシリーズのデータ項目のラベルフォーマットを保持する。

この書式は、項目が選択されたときなど、単一項目のラベルに使用される。フォーマットがどのように解釈されるかは、シリーズタイプによって異なる:QBar3DSeries QScatter3DSeries,QSurface3DSeries

アクセス関数:

QString itemLabelFormat() const
void setItemLabelFormat(const QString &format)

Notifier シグナル:

void itemLabelFormatChanged(const QString &format)

itemLabelVisible : bool

このプロパティは、グラフ内の項目ラベルの可視性を保持する。

true の場合、項目ラベルはグラフにフローティング・ラベルとして描画される。そうでない場合、項目ラベルは描画されない。外部コントロールに項目ラベルを表示するには、このプロパティをfalse に設定する。デフォルトはtrue

アクセス関数:

bool isItemLabelVisible() const
void setItemLabelVisible(bool visible)

Notifier シグナル:

void itemLabelVisibleChanged(bool visible)

itemLabelFormat およびitemLabelも参照

mesh : QAbstract3DSeries::Mesh

このプロパティは、シリーズ内のアイテムのメッシュを保持する。

QSurface3DSeries の場合、このプロパティは選択ポインタを保持します。

メッシュが MeshUserDefined の場合、アイテムを正しくレンダリングするには、userDefinedMesh プロパティも設定する必要があります。デフォルト値はグラフタイプによって異なります。

アクセス関数

QAbstract3DSeries::Mesh mesh() const
void setMesh(QAbstract3DSeries::Mesh mesh)

通知シグナル:

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)

Notifier シグナル:

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)

アクセス関数: Notifier シグナル:

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 の場合に使用されます。

注: ファイルは Wavefront OBJ フォーマットで、頂点、法線、UV を含む必要があります。また、三角形である必要があります。

アクセス関数

QString userDefinedMesh() const
void setUserDefinedMesh(const QString &fileName)

Notifier シグナル:

void userDefinedMeshChanged(const QString &fileName)

visible : bool

このプロパティは、シリーズの可視性を保持します。

このプロパティがfalse の場合、系列はレンダリングされません。デフォルトはtrue

アクセス関数:

bool isVisible() const
void setVisible(bool visible)

Notifierシグナル:

void visibleChanged(bool visible)

メンバ関数 ドキュメント

[override virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()

抽象3D系列を削除します。

[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(QVector3D axis, float angle)

axisangle からメッシュ回転四元数を作成する便利な関数です。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

meshRotationも参照してください

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。