QValue3DAxisFormatter Class

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

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

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

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