このページでは

QAbstract3DAxis Class

QAbstract3DAxis クラスは、3D グラフの軸の基底クラスです。詳細...

ヘッダー: #include <QAbstract3DAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
QML内: Abstract3DAxis
継承元: QObject
継承元:

QCategory3DAxis およびQValue3DAxis

パブリック型

enum class AxisOrientation { None, X, Y, Z }
enum class AxisType { None, Category, Value }

プロパティ

パブリック関数

virtual ~QAbstract3DAxis() override
bool isAutoAdjustRange() const
bool isScaleLabelsByCount() const
bool isTitleFixed() const
bool isTitleVisible() const
float labelAutoAngle() const
qreal labelSize() const
QStringList labels() const
bool labelsVisible() const
float max() const
float min() const
QAbstract3DAxis::AxisOrientation orientation() const
void setAutoAdjustRange(bool autoAdjust)
void setLabelAutoAngle(float degree)
void setLabelSize(qreal size)
void setLabels(const QStringList &labels)
void setLabelsVisible(bool visible)
void setMax(float max)
void setMin(float min)
void setRange(float min, float max)
void setScaleLabelsByCount(bool adjust)
void setTitle(const QString &title)
void setTitleFixed(bool fixed)
void setTitleOffset(float offset)
void setTitleVisible(bool visible)
QString title() const
float titleOffset() const
QAbstract3DAxis::AxisType type() const

シグナル

void autoAdjustRangeChanged(bool autoAdjust)
void labelAutoAngleChanged(float angle)
void labelSizeChanged(qreal size)
void labelVisibleChanged(bool visible)
void labelsChanged()
void maxChanged(float value)
void minChanged(float value)
void orientationChanged(QAbstract3DAxis::AxisOrientation orientation)
void rangeChanged(float min, float max)
void scaleLabelsByCountChanged(bool adjust)
void titleChanged(const QString &newTitle)
void titleFixedChanged(bool fixed)
void titleOffsetChanged(float offset)
void titleVisibleChanged(bool visible)

詳細な説明

このクラスは、グラフの軸に共通する列挙型、プロパティ、および関数を定義します。このクラスを直接使用すべきではなく、代わりにそのサブクラスのいずれかを使用する必要があります。

QCategory3DAxis およびQValue3DAxisも参照してください 。

メンバ型のドキュメント

enum class QAbstract3DAxis::AxisOrientation

軸オブジェクトの向き。

定数値
QAbstract3DAxis::AxisOrientation::None0
QAbstract3DAxis::AxisOrientation::X1
QAbstract3DAxis::AxisOrientation::Y2
QAbstract3DAxis::AxisOrientation::Z3

enum class QAbstract3DAxis::AxisType

軸オブジェクトの型。

定数値
QAbstract3DAxis::AxisType::None0
QAbstract3DAxis::AxisType::Category1
QAbstract3DAxis::AxisType::Value2

プロパティのドキュメント

autoAdjustRange : bool

このプロパティは、すべてのデータが軸の範囲内に収まるように、軸の範囲が自動的に調整されるかどうかを指定します。

アクセス関数:

bool isAutoAdjustRange() const
void setAutoAdjustRange(bool autoAdjust)

通知シグナル:

void autoAdjustRangeChanged(bool autoAdjust)

関連項目: setRange()、setMin()、およびsetMax()。

labelAutoAngle : float

このプロパティは、カメラの角度が変わった際にラベルが自動回転できる最大角度を指定します。

角度は0から90までの値(両端を含む)を指定できます。デフォルト値は0です。値が0の場合、軸ラベルは自動的に回転しません。値が0より大きい場合、ラベルは指定された角度の範囲内で、カメラの方向に向くように回転しようとします。

アクセス関数:

float labelAutoAngle() const
void setLabelAutoAngle(float degree)

通知シグナル:

void labelAutoAngleChanged(float angle)

[since 6.9] labelSize : qreal

ラベルのサイズ

ラベルのサイズ。この値のデフォルトは `1.0` です。

この列挙型は Qt 6.9 で導入されました。

アクセス関数:

qreal labelSize() const
void setLabelSize(qreal size)

Notifierシグナル:

void labelSizeChanged(qreal size)

「scaleLabelsByCount」も参照してください 。

labels : QStringList

このプロパティには、軸のラベルが格納されます。

注: QValue3DAxis に対してこのプロパティを設定しても 、ラベルは自動的に生成されるため、何の効果もありません。

アクセス関数:

QStringList labels() const
void setLabels(const QStringList &labels)

通知シグナル:

void labelsChanged()

labelsVisible : bool

このプロパティは、プライマリグラフビューで軸ラベルが表示されるかどうかを指定します。

デフォルト値は `true` です。

アクセス関数:

bool labelsVisible() const
void setLabelsVisible(bool visible)

通知シグナル:

void labelVisibleChanged(bool visible)

max : float

このプロパティは、軸上の最大値を保持します。

このプロパティを設定する際、範囲が有効な状態を維持できるよう、必要に応じて最小値が調整されます。

注: QCategory3DAxisの場合 、表示する最後の行または列のインデックスを指定します。

アクセス関数:

float max() const
void setMax(float max)

通知信号:

void maxChanged(float value)

min : float

このプロパティには、軸上の最小値が格納されます。

このプロパティを設定する際、範囲が有効な状態を維持できるよう、必要に応じて最大値が調整されます。

注: QCategory3DAxisの場合 、表示する最初の行または列のインデックスを指定します。

アクセス関数:

float min() const
void setMin(float min)

通知信号:

void minChanged(float value)

[read-only] orientation : QAbstract3DAxis::AxisOrientation

このプロパティは、軸の向きを保持します。

値はAxisOrientation のいずれかの値となります。

アクセス関数:

QAbstract3DAxis::AxisOrientation orientation() const

通知シグナル:

void orientationChanged(QAbstract3DAxis::AxisOrientation orientation)

[since 6.9] scaleLabelsByCount : bool

このプロパティは、ラベルの総数に基づいてラベルのサイズが自動的に調整されるかどうかに関係なく有効です

この列挙型は Qt 6.9 で導入されました。

アクセス関数:

bool isScaleLabelsByCount() const
void setScaleLabelsByCount(bool adjust)

Notifierシグナル:

void scaleLabelsByCountChanged(bool adjust)

関連項目: labelSize()。

title : QString

このプロパティは、軸のタイトルを保持します。

アクセス関数:

QString title() const
void setTitle(const QString &title)

通知信号:

void titleChanged(const QString &newTitle)

関連項目: titleVisible およびtitleFixed 。

titleFixed : bool

このプロパティは、軸タイトルの回転角度を指定します。

false の場合、プライマリグラフビューの軸タイトルは、軸ラベルと同様にカメラに向かって回転します。true の場合、軸タイトルは自身の軸を中心に回転するのみで、カメラに向かって向きは調整されません。labelAutoAngle プロパティの値が0の場合、このプロパティは効果を持ちません。デフォルト値はtrue です。

アクセス関数:

bool isTitleFixed() const
void setTitleFixed(bool fixed)

通知シグナル:

void titleFixedChanged(bool fixed)

関連項目: labelAutoAngle 、title 、およびtitleVisible 。

titleOffset : float

軸上の軸ラベルの位置。値は-1.0f から1.0f

アクセス関数:

float titleOffset() const
void setTitleOffset(float offset)

通知信号:

void titleOffsetChanged(float offset)

関連項目: title およびtitleFixed 。

titleVisible : bool

このプロパティは、メインのグラフビューで軸のタイトルが表示されるかどうかを指定します。

デフォルト値はfalse です。

アクセス関数:

bool isTitleVisible() const
void setTitleVisible(bool visible)

通知シグナル:

void titleVisibleChanged(bool visible)

「 title 」および「titleFixed 」も参照してください 。

[read-only] type : const QAbstract3DAxis::AxisType

このプロパティは、軸の型を保持します。

値は、AxisType のいずれかになります。

アクセス関数:

QAbstract3DAxis::AxisType type() const

メンバ関数のドキュメント

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

QAbstract3DAxis を削除します。

[signal] void QAbstract3DAxis::rangeChanged(float min, float max)

範囲が変更された際、その範囲の最小値と最大値(min およびmax )を出力します。

void QAbstract3DAxis::setRange(float min, float max)

軸の値の範囲を `min ` から `max` に設定します。範囲を設定する際、範囲が有効な範囲内となるよう、必要に応じて最大値が調整されます。

注: QCategory3DAxisの場合 、表示する行または列のインデックス範囲を指定します。

© 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.