このページでは

QValue3DAxis Class

QValue3DAxis クラスは、グラフの軸を操作します。詳細...

ヘッダー: #include <QValue3DAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
バージョン: QtDataVisualization 1.0
QMLにおけるバージョン: ValueAxis3D
継承元: QAbstract3DAxis
ステータス: 非推奨

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

プロパティ

パブリック関数

QValue3DAxis(QObject *parent = nullptr)
virtual ~QValue3DAxis()
QValue3DAxisFormatter *formatter() const
QString labelFormat() const
bool reversed() const
int segmentCount() const
void setFormatter(QValue3DAxisFormatter *formatter)
void setLabelFormat(const QString &format)
void setReversed(bool enable)
void setSegmentCount(int count)
void setSubSegmentCount(int count)
int subSegmentCount() const

シグナル

void formatterChanged(QValue3DAxisFormatter *formatter)
void labelFormatChanged(const QString &format)
void reversedChanged(bool enable)
void segmentCountChanged(int count)
void subSegmentCountChanged(int count)

詳細な説明

値軸には、値の範囲と、その範囲を分割するセグメントおよびサブセグメントの数を指定することができます。

各セグメントの間にラベルが描画されます。各セグメントと各サブセグメントの間にグリッド線が描画されます。

注: 表示されている場合 、セグメントは常に少なくとも 1 つ存在するため、範囲の最小値と最大値を示すグリッド線とラベルが常に少なくとも 2 つ表示されます。

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

[since QtDataVisualization 1.1] formatter : QValue3DAxisFormatter*

このプロパティには、使用する軸フォーマッタが格納されます。

新しいフォーマッタが設定されると、既存のフォーマッタはすべて削除されます。

この列挙型は、QtDataVisualization 1.1 で導入されました。

アクセス関数:

QValue3DAxisFormatter *formatter() const
void setFormatter(QValue3DAxisFormatter *formatter)

Notifier シグナル:

void formatterChanged(QValue3DAxisFormatter *formatter)

labelFormat : QString

このプロパティは、この軸のラベルに使用するラベル形式を保持します。

このフォーマット文字列は、標準C++ライブラリのprintf() で提供される以下の変換指定子、長さ修飾子、およびフラグをサポートしています:d、i、o、x、X、f、F、e、E、g、G、c。

QAbstract3DGraph::locale が"C" 以外の場合、サポートされる指定子はd、e、E、f、g、G、およびiに限定されます。また、精度修飾子のみがサポートされます。その他の書式設定は、アプリケーションのデフォルトのQLocale に基づきます。

使用例:

axis->setLabelFormat("%.2f mm");

アクセス関数:

QString labelFormat() const
void setLabelFormat(const QString &format)

通知シグナル:

void labelFormatChanged(const QString &format)

関連項目: formatter およびQAbstract3DGraph::locale 。

[since QtDataVisualization 1.1] reversed : bool

このプロパティは、軸が逆順で描画されるかどうかを指定します。

true の場合、軸は逆順で描画されます。つまり、グラフの描画時に最小値と最大値の位置が入れ替わります。このプロパティは、軸の実際の最小値および最大値には影響しません。

この列挙型は、QtDataVisualization 1.1 で導入されました。

アクセス関数:

bool reversed() const
void setReversed(bool enable)

Notifierシグナル:

void reversedChanged(bool enable)

segmentCount : int

このプロパティは、軸上のセグメント数を保持します。

これは、描画されるラベルの数を示します。描画されるグリッド線の数は、次の式で計算されます:segments * subsegments + 1 。事前設定されたデフォルト値は5 です。この値は1 を下回ることができません。

アクセス関数:

int segmentCount() const
void setSegmentCount(int count)

通知シグナル:

void segmentCountChanged(int count)

setSubSegmentCount()も参照してください 。

subSegmentCount : int

このプロパティは、軸上の各セグメント内に含まれるサブセグメントの数を保持します。

各セグメントに加え、各サブセグメントの間にもグリッド線が描画されます。デフォルト値は1 です。この値は1 を下回ってはなりません。

アクセス関数:

int subSegmentCount() const
void setSubSegmentCount(int count)

通知シグナル:

void subSegmentCountChanged(int count)

関連項目: setSegmentCount()。

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

[explicit] QValue3DAxis::QValue3DAxis(QObject *parent = nullptr)

指定されたparent を使用して、QValue3DAxisを生成します。

[virtual noexcept] QValue3DAxis::~QValue3DAxis()

QValue3DAxis を削除します。

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