QValue3DAxisFormatter Class

メンバ関数 ドキュメント

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

新しい値 3D 軸フォーマッタを、オプションの親parent で構築します。

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

値 3D 軸フォーマッタを削除します。

[protected] bool QValue3DAxisFormatter::allowNegatives() const

負の値が親軸に対して有効な値である場合、true を返します。デフォルトの実装では、常にtrue を返します。

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

[protected] bool QValue3DAxisFormatter::allowZero() const

ゼロが親軸に対して有効な値である場合はtrue を返します。既定の実装では、常にtrue を返します。

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

[protected] QValue3DAxis *QValue3DAxisFormatter::axis() const

親軸を返します。スレッド化されたレンダラーを使用する環境でスレッドの安全性を維持するために、親軸にはrecalculate() メソッドでのみアクセスする必要があります。

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

[virtual protected] QValue3DAxisFormatter *QValue3DAxisFormatter::createNewInstance() const

新しい空の値の 3D 軸フォーマッタを作成します。サブクラスで再実装する必要があります。

新しいフォーマッタを返します。レンダラーはこのメソッドを使用してフォーマッタのコピーをキャッシュします。新しいコピーの所有権は呼び出し元に移ります。

[protected] QList<float> QValue3DAxisFormatter::gridPositions() &&

正規化したグリッド線の位置を配列で返します。デフォルトの配列サイズは、親軸のセグメントカウントに 1 を足した値ですが、recalculate() メソッドのサブクラス化された実装では、配列のサイズが異なる場合があります。

QValue3DAxis::segmentCount およびrecalculate()も参照して ください。

[protected] const QList<float> &QValue3DAxisFormatter::gridPositions() const &

正規化されたグリッド線位置の配列への参照を返します。デフォルトの配列サイズは、親軸のセグメントカウントに 1 を足したものですが、recalculate() メソッドのサブクラス化された実装では、配列のサイズが異なる場合があります。

QValue3DAxis::segmentCount およびrecalculate()も参照して ください。

[protected] QList<float> QValue3DAxisFormatter::labelPositions() &&

値によって正規化されたラベル位置の配列を返します。既定の配列サイズは、親軸のセグメント・カウントに 1 を足した値ですが、recalculate() メソッドのサブクラス化された実装では、配列のサイズが異なる場合があります。デフォルトでは、インデックス 0 のラベルは軸の最小値に対応します。

QValue3DAxis::segmentCount 、QAbstract3DAxis::labels 、およびrecalculate()も参照して ください。

[protected] const QList<float> &QValue3DAxisFormatter::labelPositions() const &

正規化されたラベル位置の配列への参照を返します。既定の配列サイズは、親軸のセグメント・カウントに 1 を足したものですが、recalculate() メソッドのサブクラス化された実装では、配列のサイズが異なる場合があります。デフォルトでは、インデックス 0 のラベルは軸の最小値に対応します。

QValue3DAxis::segmentCount 、QAbstract3DAxis::labels 、およびrecalculate()も参照して ください。

[protected] QStringList QValue3DAxisFormatter::labelStrings() &&

フォーマッタ・ラベル文字列を含む文字列リストを値で返します。

setLabelStrings() およびlabelPositions() も参照 。

[protected] const QStringList &QValue3DAxisFormatter::labelStrings() const &

フォーマッタ・ラベル文字列を含む文字列リストへの参照を返します。

labelPositions()も参照 ください。

[protected] QLocale QValue3DAxisFormatter::locale() const

このフォーマッタが現在使用しているロケールを返します。

setLocale()も参照 ください。

[protected] void QValue3DAxisFormatter::markDirty(bool labelsChange = false)

このフォーマッタをダーティとしてマークし、 次回のレンダラー同期時にキャッシュの新しいコピーを作成するように促します。このメソッドは、解決された値に影響を与えるような形でフォーマッタが変更されるたびにサブクラスからコールされなければなりません。変更によって親軸ラベル文字列を再生成する必要がある場合は、labelsChange をtrue に設定します。

[virtual protected] void QValue3DAxisFormatter::populateCopy(QValue3DAxisFormatter &copy)

このフォーマッタで位置、値、および文字列を解決するために必要なすべての値を、フォーマッタのcopy にコピーします。サブクラスでこのメソッドを再実装する場合は、ある時点でスーパークラスのバージョンを呼び出します。レンダラーは、このメソッドを使用してフォーマッターのコピーをキャッシュします。

新しいコピーを返します。新しいコピーの所有権は呼び出し元に移ります。

[virtual protected] float QValue3DAxisFormatter::positionAt(float value) const

与えられたvalue の軸に沿った正規化された位置を返します。返される値は、値が親軸の範囲内にある場合、0.0 （最小値）と1.0 （最大値）の間でなければなりません。

親軸の最小値と最大値の間の線形補間によって位置を解決できない場合は、このメソッドを再実装します。

recalculate() およびvalueAt()も参照して ください。

[virtual protected] void QValue3DAxisFormatter::recalculate()

ラベルとグリッド線の位置配列、およびラベル文字列配列のサイズ変更と入力を行い、値をその位置にマッピングするために必要な値を計算します。親軸は、この関数の内部からアクセスできます。

デフォルトの配列内容が適切でない場合は、このメソッドをサブクラスで再実装する必要があります。

サイズ変更と入力が必要な配列に関するドキュメントは、gridPositions()、subGridPositions()、labelPositions()、およびlabelStrings() メソッドを参照してください。

gridPositions(),subGridPositions(),labelPositions(),labelStrings(),axis()も参照して ください。

[protected] void QValue3DAxisFormatter::setAllowNegatives(bool allow)

allow がtrue の場合、親軸が負の値を持つことを許可します。

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

[protected] void QValue3DAxisFormatter::setAllowZero(bool allow)

allow がtrue の場合、親軸がゼロ値を持つことを許可します。

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

[protected] void QValue3DAxisFormatter::setGridPoitions(QList<float> gridPositions)

gridPositions からの新しいグリッド位置のリストを設定します。値は、0.0 (最小値) から1.0 (最大値) の間でなければなりません (この値を含みます)。

QValue3DAxis::segmentCount 、recalculate()、およびgridPositionsも参照 。

[protected] void QValue3DAxisFormatter::setLabelStrings(QStringList labelStrings)

labelStrings から、新しいラベル文字列のリストを設定する。 配列のサイズは、ラベル位置配列のサイズと等しくなければならない。

labelPositions() およびlabelStrings()も参照 。

[protected] void QValue3DAxisFormatter::setLocale(const QLocale &locale)

このフォーマッタが使用するlocale を設定します。親軸がグラフのアクティブ軸として設定されたり、軸フォーマッタがグラフに接続された軸に設定されたり、グラフのロケールが変更されたりすると、グラフは自動的にフォーマッタのロケールをグラフのロケールに設定します。

locale() およびQ3DGraphsWidgetItem::localeも参照のこと 。

[protected] void QValue3DAxisFormatter::setSubGridPositions(QList<float> subGridPositions)

subGridPositions から新しいサブグリッド位置のリストを設定する。値は0.0 （最小値）から1.0 （最大値）の間でなければならない。

QValue3DAxis::segmentCount,QValue3DAxis::subSegmentCount,recalculate(), およびsubGridPositionsも参照のこと 。

[protected] void QValue3DAxisFormatter::setlabelPositions(QList<float> labelPositions)

labelPositions からの新しいラベル位置のリストを設定する。値は、0.0 （最小値）から1.0 （最大値）の間でなければならない。

QValue3DAxis::segmentCount 、QAbstract3DAxis::labels 、recalculate （）、labelPositions （）も参照のこと 。

[virtual protected] QString QValue3DAxisFormatter::stringForValue(qreal value, const QString &format)

指定されたvalue およびformat を使用してフォーマットされたラベル文字列を返します。

QValue3DAxis::labelFormat プロパティに指定されたデフォルトのフォーマット規則が十分でない場合、指定されたvalue のフォーマットされた文字列を解決するために、サブクラスでこのメソッドを再実装します。

recalculate()、labelStrings()、およびQValue3DAxis::labelFormatも参照してください 。

[protected] QList<float> QValue3DAxisFormatter::subGridPositions() &&

正規化されたサブグリッド行位置の配列を値で返す。既定の配列サイズは、親軸のセグメント数×親軸のサブセグメント数から 1 を引いた値ですが、recalculate() メソッドのサブクラス化された実装では、配列のサイズが異なる場合があります。

setSubGridPositions()、QValue3DAxis::segmentCount 、QValue3DAxis::subSegmentCount 、およびrecalculate()も参照して ください。

[protected] const QList<float> &QValue3DAxisFormatter::subGridPositions() const &

正規化されたサブグリッド線の位置の配列への参照を返します。デフォルトの配列サイズは、親軸のセグメントカウント×親軸のサブセグメントカウントから 1 を引いた値ですが、recalculate() メソッドのサブクラス化された実装では、配列のサイズが異なる場合があります。

QValue3DAxis::segmentCount 、QValue3DAxis::subSegmentCount 、およびrecalculate()も参照 。

[virtual protected] float QValue3DAxisFormatter::valueAt(float position) const

軸に沿って正規化されたposition の値を返します。position 値は、親軸範囲内の値を得るために、0.0 (最小値) と1.0 (最大値) の間でなければなりません。

親軸の最小値と最大値の間の線形補間によって値を解決できない場合は、このメソッドを再実装します。

recalculate() およびpositionAt()も参照してください 。