QValue3DAxisFormatter Class

Dokumentation der Mitgliedsfunktionen

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

Erstellt einen neuen 3D-Achsenformatierer mit dem optionalen übergeordneten Objekt „ parent “.

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

Löscht den Wert „3D-Achsenformatierer“.

[protected] bool QValue3DAxisFormatter::allowNegatives() const

Gibt „ true “ zurück, wenn negative Werte für die übergeordnete Achse zulässig sind. Die Standardimplementierung gibt immer „ true “ zurück.

Siehe auch setAllowNegatives().

[protected] bool QValue3DAxisFormatter::allowZero() const

Gibt „ true “ zurück, wenn „zero“ ein gültiger Wert für die übergeordnete Achse ist. Die Standardimplementierung gibt immer „ true “ zurück.

Siehe auch setAllowZero().

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

Gibt die übergeordnete Achse zurück. Der Zugriff auf die übergeordnete Achse darf ausschließlich über die Methode ` recalculate()` erfolgen, um die Thread-Sicherheit in Umgebungen zu gewährleisten, in denen ein Thread-basierter Renderer verwendet wird.

Siehe auch ` recalculate()`.

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

Erstellt einen neuen, leeren 3D-Achsen-Formatierer. Muss in einer Unterklasse neu implementiert werden.

Gibt den neuen Formatierer zurück. Der Renderer verwendet diese Methode, um eine Kopie des Formatierers zwischenzuspeichern. Die Eigentumsrechte an der neuen Kopie werden auf den Aufrufer übertragen.

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

Gibt ein Array mit normalisierten Gitterlinienpositionen nach Wert zurück. Die Standardgröße des Arrays entspricht der Anzahl der Segmente der übergeordneten Achse plus eins; eine in einer Unterklasse implementierte Version der Methode ` recalculate()` kann die Größe des Arrays jedoch anders festlegen.

Siehe auch ` QValue3DAxis::segmentCount ` und ` recalculate()`.

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

Gibt eine Referenz auf das Array der normierten Gitterlinienpositionen zurück. Die Standardgröße des Arrays entspricht der Anzahl der Segmente der übergeordneten Achse plus eins; eine in einer Unterklasse implementierte Version der Methode ` recalculate()` kann die Größe des Arrays jedoch anders festlegen.

Siehe auch ` QValue3DAxis::segmentCount ` und ` recalculate()`.

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

Gibt ein Array mit normalisierten Beschriftungspositionen nach Wert zurück. Die Standardgröße des Arrays entspricht der Anzahl der Segmente der übergeordneten Achse plus eins; eine Unterklassenimplementierung der Methode ` recalculate()` kann die Größe des Arrays jedoch anders festlegen. Standardmäßig entspricht die Beschriftung am Index Null dem Minimalwert der Achse.

Siehe auch QValue3DAxis::segmentCount, QAbstract3DAxis::labels und recalculate().

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

Gibt eine Referenz auf das Array der normalisierten Beschriftungspositionen zurück. Die Standardgröße des Arrays entspricht der Anzahl der Segmente der übergeordneten Achse plus eins; eine in einer Unterklasse implementierte Version der Methode ` recalculate()` kann die Größe des Arrays jedoch anders festlegen. Standardmäßig entspricht die Beschriftung am Index Null dem Minimalwert der Achse.

Siehe auch QValue3DAxis::segmentCount, QAbstract3DAxis::labels und recalculate().

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

Gibt eine Zeichenfolgenliste nach Wert zurück, die Formatierungsbezeichner enthält.

Siehe auch „ setLabelStrings()“ und „ labelPositions()“.

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

Gibt eine Referenz auf die Zeichenfolgenliste zurück, die die Beschriftungszeichenfolgen des Formatierers enthält.

Siehe auch labelPositions().

[protected] QLocale QValue3DAxisFormatter::locale() const

Gibt die aktuelle Locale zurück, die dieser Formatierer verwendet.

Siehe auch ` setLocale()`.

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

Markiert diesen Formatter als „dirty“ und veranlasst den Renderer, bei der nächsten Renderer-Synchronisation eine neue Kopie seines Caches zu erstellen. Diese Methode sollte von einer Unterklasse aufgerufen werden, sobald der Formatter so geändert wird, dass sich dies auf die aufgelösten Werte auswirkt. Setzen Sie „ labelsChange “ auf „ true “, wenn die Änderung eine Neuerstellung der Achsenbeschriftungszeichenfolgen des übergeordneten Elements erfordert.

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

Kopiert alle Werte, die zur Auflösung von Positionen, Werten und Zeichenketten mit diesem Formatierer erforderlich sind, in die „ copy “ des Formatierers. Wenn Sie diese Methode in einer Unterklasse neu implementieren, rufen Sie an einer Stelle die Version der Oberklasse auf. Der Renderer verwendet diese Methode, um eine Kopie des Formatierers zwischenzuspeichern.

Gibt die neue Kopie zurück. Das Eigentumsrecht an der neuen Kopie geht auf den Aufrufer über.

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

Gibt die normierte Position entlang der Achse für die angegebene „ value “ zurück. Der zurückgegebene Wert sollte zwischen 0.0 (dem Minimalwert) und 1.0 (dem Maximalwert) liegen (einschließlich), sofern der Wert innerhalb des Bereichs der übergeordneten Achse liegt.

Implementieren Sie diese Methode neu, wenn die Position nicht durch lineare Interpolation zwischen den Minimal- und Maximalwerten der übergeordneten Achse ermittelt werden kann.

Siehe auch recalculate() und valueAt().

[virtual protected] void QValue3DAxisFormatter::recalculate()

Passen die Größe der Arrays für die Beschriftungen und Gitterlinienpositionen sowie des Arrays für die Beschriftungszeichenfolgen an und füllen diese mit Werten; außerdem werden alle Werte berechnet, die erforderlich sind, um einen Wert seiner Position zuzuordnen. Auf die übergeordnete Achse kann innerhalb dieser Funktion zugegriffen werden.

Diese Methode muss in einer Unterklasse neu implementiert werden, wenn die Standardinhalte der Arrays nicht geeignet sind.

Siehe die Methoden „ gridPositions()“, „ subGridPositions()“, „ labelPositions()“ und „ labelStrings()“ für Dokumentation zu den Arrays, deren Größe angepasst und deren Inhalt gefüllt werden muss.

Siehe auch die Methoden gridPositions(), subGridPositions(), labelPositions(), labelStrings() und axis().

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

Ermöglicht negative Werte für die übergeordnete Achse, wenn „ allow “ auf „ true “ gesetzt ist.

Siehe auch ` allowNegatives()`.

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

Ermöglicht es, dass die übergeordnete Achse den Wert Null annimmt, wenn „ allow “ auf „ true “ gesetzt ist.

Siehe auch „ allowZero()“.

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

Legt eine Liste neuer Rasterpositionen aus gridPositions fest. Die Werte sollten zwischen 0.0 (Mindestwert) und 1.0 (Höchstwert) liegen, einschließlich dieser Werte.

Siehe auch QValue3DAxis::segmentCount, recalculate() und gridPositions.

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

Legt eine Liste neuer Beschriftungszeichenfolgen aus „ labelStrings “ fest. Die Größe des Arrays muss der Größe des Arrays mit den Beschriftungspositionen entsprechen, auf die die Indizes ebenfalls verweisen.

Siehe auch labelPositions() und labelStrings().

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

Legt die „ locale “ fest, die dieser Formatierer verwendet. Das Diagramm setzt die Locale des Formatierers automatisch auf die Locale des Diagramms, sobald die übergeordnete Achse als aktive Achse des Diagramms festgelegt wird, der Achsformatierer auf eine dem Diagramm zugeordnete Achse gesetzt wird oder sich die Locale des Diagramms ändert.

Siehe auch „ locale()“ und „ Q3DGraphsWidgetItem::locale “.

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

Legt eine Liste neuer Untergitterpositionen aus subGridPositions fest. Die Werte sollten zwischen 0.0 (Mindestwert) und 1.0 (Höchstwert) liegen, einschließlich dieser Werte.

Siehe auch QValue3DAxis::segmentCount, QValue3DAxis::subSegmentCount, recalculate() und subGridPositions.

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

Legt eine Liste mit neuen Label-Positionen aus „ labelPositions “ fest. Die Werte sollten zwischen „ 0.0 “ (Mindestwert) und „ 1.0 “ (Höchstwert) liegen, einschließlich dieser Werte.

Siehe auch QValue3DAxis::segmentCount, QAbstract3DAxis::labels, recalculate() und labelPositions().

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

Gibt die formatierte Beschriftung unter Verwendung der angegebenen Werte für ` value ` und ` format` zurück.

Implementieren Sie diese Methode in einer Unterklasse neu, um die formatierte Zeichenfolge für eine bestimmte ` value ` zu ermitteln, falls die für die Eigenschaft ` QValue3DAxis::labelFormat ` festgelegten Standardformatierungsregeln nicht ausreichen.

Siehe auch „ recalculate()“, „ labelStrings()“ und „ QValue3DAxis::labelFormat “.

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

Gibt ein Array mit normalisierten Positionen der Untergitterlinien nach Wert zurück. Die Standardgröße des Arrays entspricht der Segmentanzahl der übergeordneten Achse multipliziert mit der Untersegmentanzahl der übergeordneten Achse minus eins; eine in einer Unterklasse implementierte Version der Methode ` recalculate()` kann die Größe des Arrays jedoch anders festlegen.

Siehe auch setSubGridPositions(), QValue3DAxis::segmentCount, QValue3DAxis::subSegmentCount und recalculate().

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

Gibt eine Referenz auf das Array der normalisierten Positionen der Untergitterlinien zurück. Die Standardgröße des Arrays entspricht der Anzahl der Segmente der übergeordneten Achse multipliziert mit der Anzahl der Untersegmente der übergeordneten Achse minus eins; eine in einer Unterklasse implementierte Version der Methode ` recalculate()` kann die Größe des Arrays jedoch anders festlegen.

Siehe auch ` QValue3DAxis::segmentCount`, ` QValue3DAxis::subSegmentCount` und ` recalculate()`.

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

Gibt den Wert an der normalisierten Koordinate position entlang der Achse zurück. Der Wert „ position “ sollte zwischen 0.0 (dem Minimalwert) und 1.0 (dem Maximalwert) liegen (einschließlich), um Werte innerhalb des Bereichs der übergeordneten Achse zu erhalten.

Implementieren Sie diese Methode neu, wenn der Wert nicht durch lineare Interpolation zwischen den Minimal- und Maximalwerten der übergeordneten Achse ermittelt werden kann.

Siehe auch „ recalculate()“ und „ positionAt()“.