QValue3DAxisFormatter Class

メンバ関数 ドキュメント

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

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

[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() const

正規化されたグリッド線位置の配列への参照を返します。デフォルトの配列サイズは、親軸のセグメントカウントに 1 を足した値ですが、recalculate() メソッドのサブクラスの実装では、配列のサイズを変更することができます。値は、0.0 (最小値) と1.0 (最大値) の間でなければなりません。

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

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

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

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

[protected] 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) const

このフォーマッタで位置、値、および文字列を解決するために必要なすべての値を、フォーマッタの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::setLocale(const QLocale &locale)

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

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

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

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

QValue3DAxis::labelFormat プロパティに指定された既定の書式設定規則が十分でない場合は、サブクラスでこのメソッドを再実装して、指定されたvalue の書式付き文字列を解決します。

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

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

正規化されたサブグリッド線位置の配列への参照を返します。既定の配列サイズは、親軸のセグメントカウント×親軸のサブセグメントカウントから 1 を引いた値ですが、recalculate() メソッドのサブクラス化された実装では、配列のサイズが異なる場合があります。値は、0.0 （最小値）と1.0 （最大値）の間でなければならない。

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

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

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

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

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