QValue3DAxisFormatter Class

Dokumentation der Mitgliedsfunktionen

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

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

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

Gibt eine Referenz auf das Array der normalisierten Gitterlinienpositionen zurück. Die Standardgröße des Arrays entspricht der Segmentanzahl der übergeordneten Achse plus eins; eine in einer Unterklasse implementierte Version der Methode ` recalculate()` kann die Größe des Arrays jedoch anders festlegen. Die Werte sollten zwischen 0.0 (Mindestwert) und 1.0 (Höchstwert) liegen, einschließlich dieser Werte.

Siehe auch QValue3DAxis::segmentCount und recalculate().

[protected] 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 Unterklassenimplementierung der Methode „ recalculate()“ kann die Größe des Arrays jedoch anders anpassen. Die Werte sollten zwischen 0.0 (dem Minimalwert) und 1.0 (dem Maximalwert) liegen, einschließlich dieser Werte. Standardmäßig entspricht die Beschriftung am Index Null dem Minimalwert der Achse.

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

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

Gibt eine Referenz auf die Zeichenfolgenliste zurück, die die Beschriftungszeichenfolgen des Formatierers enthält. Die Größe des Arrays muss der Größe des Arrays mit den Beschriftungspositionen entsprechen, auf die sich die Indizes ebenfalls beziehen.

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“, wodurch der Renderer dazu veranlasst wird, bei der nächsten Synchronisierung des Renderers 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) const

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 (Mindestwert) und 1.0 (Höchstwert) 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 Daten; 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::setLocale(const QLocale &locale)

Legt die „ locale “ fest, die dieser Formatierer verwendet. Das Diagramm legt die Locale des Formatierers automatisch auf die Locale des Diagramms fest, 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 „ QAbstract3DGraph::locale “.

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

Gibt die formatierte Beschriftung unter Verwendung der angegebenen „ 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() const

Gibt eine Referenz auf das Array der normalisierten Positionen der Untergitterlinien 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. Die Werte sollten zwischen 0.0 (dem Minimalwert) und 1.0 (dem Maximalwert) liegen, einschließlich dieser Werte.

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()“.