ValueAxis QML Type

Fügt Werte zu den Achsen eines Diagramms hinzu. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder
• „ValueAxis“ ist Teil der „Qt Graphs “-QML-Typen für 2D.

Eigenschaften

• labelDecimals : int
• labelFormat : string
• labelPostFormat : string (since 6.12)
• max : real
• min : real
• pan : real (since 6.9)
• subTickCount : int
• tickAnchor : real
• tickInterval : real
• visualMax : real (since 6.11)
• visualMin : real (since 6.11)
• zoom : real (since 6.9)

Signale

• labelDecimalsChanged(int decimals)
• labelFormatChanged(string format)
• labelPostFormatChanged(string format) (since 6.12)
• maxChanged(real max)
• minChanged(real min)
• rangeChanged(real min, real max)
• subTickCountChanged(int subTickCount)
• tickAnchorChanged(real tickAnchor)
• tickIntervalChanged(real tickInterval)

Ausführliche Beschreibung

Der Typ „ValueAxis“ kann so konfiguriert werden, dass eine Achsenlinie mit Skalenmarkierungen, Gitterlinien und Schattierungen angezeigt wird. Die Werte auf der Achse werden an den Positionen der Skalenmarkierungen dargestellt.

Der folgende Beispielcode veranschaulicht die Verwendung des „ValueAxis“-Typs:

GraphsView {
    axisX: ValueAxis {
        max: 10
        tickInterval: 1
    }
    axisY: ValueAxis {
        min -20
        max: 40
    }
    LineSeries {
        // Add a few XYPoint data...
    }
}

Dokumentation zu den Eigenschaften

labelDecimals : int

Die Anzahl der Dezimalstellen, die für die Anzeige der Beschriftungen verwendet werden. Bei der Einstellung -1 wird die Anzahl der Dezimalstellen automatisch entsprechend dem Wertebereich angepasst. Der Standardwert ist -1.

labelFormat : string

Die Formatzeichenfolge unterstützt die folgenden Konvertierungsspezifizierer, Längenmodifikatoren und Flags, die von der Funktion ` printf() ` in der C++-Standardbibliothek bereitgestellt werden: d, i, o, x, X, f, F, e, E, g, G, c. Anschließend wird die formatierte Zeichenfolge durch die Funktion ` ValueAxis::labelPostFormat` verarbeitet.

Der Standardwert ist leer; in diesem Fall wird das Format „f“ verwendet.

ValueAxis {
    titleText: "Temperature °C"
    labelFormat: "%.2f"
    labelPostFormat: "%1 °C"
    // Results in "2.50 °C"
}

Siehe auch QString::asprintf().

labelPostFormat : string [since 6.12]

Die Beschriftung wird zunächst über „ ValueAxis::labelFormat “ geleitet, um den Wert zu formatieren, und anschließend über diese Funktion.

Der Standardwert lautet „%1“.

ValueAxis {
    titleText: "Temperature °C"
    labelFormat: "%.2f"
    labelPostFormat: "%1 °C"
    // Results in "2.50 °C"
}

Diese Eigenschaft wurde in Qt 6.12 eingeführt.

Siehe auch QString::arg().

max : real

Der Maximalwert auf der Achse.

Bei der Festlegung dieser Eigenschaft wird der Minimalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt. Der Standardwert beträgt 10,0.

min : real

Der Minimalwert auf der Achse.

Bei der Festlegung dieser Eigenschaft wird der Maximalwert gegebenenfalls angepasst, um sicherzustellen, dass der Bereich gültig bleibt. Der Standardwert ist 0,0.

pan : real [since 6.9]

Der „Pan“-Wert der Achse.

Der „pan“-Wert verschiebt den Mittelpunkt der Achse, ohne die Abstände des Rasters und der Beschriftungen zu beeinflussen. Der Standardwert ist 0.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

subTickCount : int

Die Anzahl der Untermarkierungen auf der Achse. Dieser Wert gibt an, wie viele Untermarkierungen zwischen den Hauptlinien im Diagramm eingezeichnet werden. Für Untermarkierungen werden keine Beschriftungen angezeigt. Der Standardwert ist 0.

tickAnchor : real

Der Basiswert, von dem aus die dynamisch platzierten Skalenmarkierungen und Beschriftungen beginnen. Der Standardwert ist 0.

tickInterval : real

Der Abstand zwischen dynamisch platzierten Skalenstrichen und Beschriftungen. Der Standardwert ist 0, was bedeutet, dass die Abstände automatisch auf der Grundlage des Minimal- und Maximalbereichs berechnet werden.

visualMax : real [read-only, since 6.11]

Der visuelle Maximalwert der Achse.

Diese Eigenschaft enthält den visuellen Maximalwert der Achse, wenn die Achse verschoben oder gezoomt wurde. Der Standardwert ist max

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

visualMin : real [read-only, since 6.11]

Der visuelle Mindestwert der Achse.

Diese Eigenschaft enthält einen visuellen Mindestwert der Achse, wenn die Achse verschoben oder gezoomt wurde. Der Standardwert ist min

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

zoom : real [since 6.9]

Der Zoomwert der Achse.

Der Zoomwert vergrößert oder verkleinert die Achse und damit das Diagramm, ohne die Intervalle des Rasters und der Beschriftungen zu beeinflussen. Der Standardwert ist 1.

Diese Eigenschaft wurde in Qt 6.9 eingeführt.

Signal-Dokumentation

labelDecimalsChanged(int decimals)

Dieses Signal wird ausgelöst, wenn sich die Anzahl der Dezimalstellen der Achsenbeschriftung auf decimals ändert.

labelFormatChanged(string format)

Dieses Signal wird ausgelöst, wenn sich das Format der Achsenbeschriftungen auf „ format “ ändert.

[since 6.12] labelPostFormatChanged(string format)

Dieses Signal wird ausgelöst, wenn sich das Post-Format der Achsenbeschriftungen auf „ format “ ändert.

Dieses Signal wurde in Qt 6.12 eingeführt.

maxChanged(real max)

Dieses Signal wird ausgelöst, wenn sich der Maximalwert der Achse auf max ändert.

minChanged(real min)

Dieses Signal wird ausgelöst, wenn sich der Minimalwert der Achse auf min ändert.

rangeChanged(real min, real max)

Dieses Signal wird ausgelöst, wenn sich der Minimal- bzw. Maximalwert der Achse auf min bzw. max ändert.

subTickCountChanged(int subTickCount)

Dieses Signal wird ausgelöst, wenn sich die Anzahl der Subticks auf der Achse, die durch subTickCount festgelegt ist, ändert.

tickAnchorChanged(real tickAnchor)

Dieses Signal wird ausgelöst, wenn sich der Tick-Ankerwert auf tickAnchor ändert.

tickIntervalChanged(real tickInterval)

Dieses Signal wird ausgelöst, wenn sich der Wert des Tick-Intervalls auf „ tickInterval “ ändert.