QValue3DAxisFormatter Class

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

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

オプションの親parent を使用して、新しい値の3D軸フォーマッタを作成します。

[virtual noexcept] QValue3DAxisFormatter::~QValue3DAxisFormatter()

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

[protected] bool QValue3DAxisFormatter::allowNegatives() const

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

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

[protected] bool QValue3DAxisFormatter::allowZero() const

親軸において zero が有効な値である場合、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 の場合、親軸の値が0になるようにします。

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()も参照してください 。