このページでは

QValue3DAxis Class

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

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

プロパティ

パブリック関数

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

シグナル

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

詳細な説明

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

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

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

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

formatter : QValue3DAxisFormatter*

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

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

アクセス関数:

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

通知シグナル:

void formatterChanged(QValue3DAxisFormatter *formatter)

labelFormat : QString

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

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

Q3DGraphsWidgetItem::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 およびQ3DGraphsWidgetItem::locale 。

reversed : bool

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

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

アクセス関数:

bool reversed() const
void setReversed(bool enable)

通知シグナル:

void reversedChanged(bool enable)

segmentCount : qsizetype

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

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

アクセス関数:

qsizetype segmentCount() const
void setSegmentCount(qsizetype count)

通知シグナル:

void segmentCountChanged(qsizetype count)

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

subSegmentCount : qsizetype

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

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

アクセス関数:

qsizetype subSegmentCount() const
void setSubSegmentCount(qsizetype count)

通知シグナル:

void subSegmentCountChanged(qsizetype count)

関連項目: setSegmentCount()。

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

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

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

[override 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.