ChartView QML Type

Verwaltet die grafische Darstellung der Diagrammreihen, Legenden und Achsen. Mehr...

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• animationDuration : int
• animationEasingCurve : easing
• animationOptions : enumeration
• axes : list<AbstractAxis>
• backgroundColor : color
• backgroundRoundness : real
• count : int
• dropShadowEnabled : bool
• legend : Legend
• locale : locale (since QtCharts 2.0)
• localizeNumbers : bool (since QtCharts 2.0)
• margins : Margins
• plotArea : rect
• plotAreaColor : color
• theme : enumeration
• title : string
• titleColor : color
• titleFont : font

Signale

• seriesAdded(AbstractSeries series)
• seriesRemoved(AbstractSeries series)

Methoden

• Axis axisX(AbstractSeries series)
• Axis axisY(AbstractSeries series)
• AbstractSeries createSeries(enumeration type, string name, AbstractAxis axisX, AbstractAxis axisY)
• bool isZoomed()
• point mapToPosition(point value, AbstractSeries series)
• point mapToValue(point position, AbstractSeries series)
• void removeAllSeries()
• void removeSeries(AbstractSeries series)
• void scrollDown(real pixels)
• void scrollLeft(real pixels)
• void scrollRight(real pixels)
• void scrollUp(real pixels)
• AbstractSeries series(int index)
• AbstractSeries series(string name)
• void setAxisX(AbstractAxis axis, AbstractSeries series)
• void setAxisY(AbstractAxis axis, AbstractSeries series)
• void zoom(real factor)
• void zoomIn()
• void zoomIn(rect rectangle)
• void zoomOut()
• void zoomReset()

Ausführliche Beschreibung

Der Typ „ChartView“ stellt verschiedene Serientypen als Diagramme dar.

Dieses Beispiel zeigt, wie man ein einfaches Liniendiagramm erstellt:

ChartView {
    title: "Line Chart"
    anchors.fill: parent
    antialiasing: true

    LineSeries {
        name: "Line"
        XYPoint { x: 0; y: 0 }
        XYPoint { x: 1.1; y: 2.1 }
        XYPoint { x: 1.9; y: 3.3 }
        XYPoint { x: 2.1; y: 2.1 }
        XYPoint { x: 2.9; y: 4.9 }
        XYPoint { x: 3.4; y: 3.0 }
        XYPoint { x: 4.1; y: 3.3 }
    }
}

Dokumentation zu den Eigenschaften

animationDuration : int

Die Dauer der Animation für das Diagramm.

animationEasingCurve : easing

Die Abklingkurve der Animation für das Diagramm.

animationOptions : enumeration

Die im Diagramm aktivierten Animationen:

axes : list<AbstractAxis>

Die Achsen des Diagramms.

backgroundColor : color

Die Farbe des Diagrammhintergrunds. Standardmäßig wird die Hintergrundfarbe durch das Diagrammdesign festgelegt.

Siehe auch theme.

backgroundRoundness : real

Der Durchmesser des Abrundungskreises an den Ecken des Diagrammhintergrunds.

count : int

Die Anzahl der Reihen, die in die Tabelle aufgenommen wurden.

dropShadowEnabled : bool

Gibt an, ob der Hintergrund-Schlagschatteneffekt aktiviert ist.

Bei der Einstellung „ true “ ist der Hintergrund-Schlagschatten-Effekt aktiviert. Bei der Einstellung „ false “ ist er deaktiviert.

legend : Legend

Die Legende des Diagramms. In der Legende sind alle Reihen, Tortenstücke und Balkensätze aufgeführt, die dem Diagramm hinzugefügt wurden.

locale : locale [since QtCharts 2.0]

Die Locale, die zur Formatierung verschiedener Diagrammbeschriftungen verwendet wird.

Beschriftungen werden nur lokalisiert, wenn „ localizeNumbers “ auf „ true “ gesetzt ist, mit Ausnahme von „DateTimeAxis“-Beschriftungen, die stets die mit dieser Eigenschaft festgelegte „ QLocale “ verwenden.

Standardmäßig wird die zum Zeitpunkt der Erstellung des Diagramms gültige Standard-Locale der Anwendung verwendet.

Diese Eigenschaft wurde in QtCharts 2.0 eingeführt.

Siehe auch „ localizeNumbers “.

localizeNumbers : bool [since QtCharts 2.0]

Ob Zahlen lokalisiert werden.

Wenn „ true “ gesetzt ist, werden alle generierten Zahlen, die in verschiedenen Reihen und Achsenbeschriftungen erscheinen, anhand der mit der Eigenschaft „ locale “ festgelegten „ QLocale “ lokalisiert. Wenn „ false “ gesetzt ist, wird immer die Locale „C“ verwendet. Der Standardwert ist „ false “.

Diese Eigenschaft wurde in QtCharts 2.0 eingeführt.

Siehe auch „ locale “.

margins : Margins

Die zulässigen Mindestränder zwischen dem Rand des Diagrammrechtecks und dem Darstellungsbereich. Die Ränder werden zum Einzeichnen des Titels, der Achsen und der Legende verwendet.

plotArea : rect

Das Rechteck, in dem das Diagramm gezeichnet wird.

Der Darstellungsbereich umfasst nicht den durch die Ränder definierten Bereich. Standardmäßig passt sich die Größe an, wenn er sich innerhalb eines „ ChartView “ befindet. Wenn ein explizites Rechteck für den Darstellungsbereich festgelegt ist, wird dieses berücksichtigt. Um zum Standardverhalten zurückzukehren, setzen Sie den Wert auf „ Qt.rect(0, 0, 0, 0) “.

Siehe auch „ margins “.

plotAreaColor : color

Die Farbe des Hintergrunds im Darstellungsbereich des Diagramms. Standardmäßig wird für den Hintergrund des Darstellungsbereichs die Hintergrundfarbe des Diagramms verwendet, die durch das Diagrammdesign festgelegt ist.

Siehe auch „ backgroundColor “ und „ theme “.

theme : enumeration

Das vom Diagramm verwendete Design.

Ein Design ist eine integrierte Sammlung von Einstellungen zum UI-Stil, die auf alle visuellen Elemente eines Diagramms angewendet werden, wie z. B. Farben, Stifte, Pinsel und Schriftarten der Reihen sowie Achsen, Titel und Legende. Das Beispiel „Qml Oscilloscope“ veranschaulicht, wie ein Design festgelegt wird.

Die folgenden Werte werden unterstützt:

title : string

Der Titel wird als Überschrift oben im Diagramm angezeigt. Diagrammtitel unterstützen HTML-Formatierungen.

Siehe auch titleColor.

titleColor : color

Die Farbe des Titeltextes.

titleFont : font

Die Schriftart der Diagrammüberschrift.

Weitere Informationen finden Sie unter font.

Signal-Dokumentation

seriesAdded(AbstractSeries series)

Dieses Signal wird ausgegeben, wenn die Reihe „ series “ zum Diagramm hinzugefügt wird.

seriesRemoved(AbstractSeries series)

Dieses Signal wird ausgelöst, wenn das Zeitreihenobjekt „ series “ aus dem Diagramm entfernt wird. Das Zeitreihenobjekt wird ungültig, sobald der Signal-Handler die Ausführung abgeschlossen hat.

Methodendokumentation

Axis axisX(AbstractSeries series)

Die x-Achse des series.

Siehe auch setAxisX().

Axis axisY(AbstractSeries series)

Die y-Achse des series.

Siehe auch setAxisY().

AbstractSeries createSeries(enumeration type, string name, AbstractAxis axisX, AbstractAxis axisY)

Fügt dem Diagramm eine Reihe vom Typ „ type “ mit dem Namen „ name “ und optional den Achsen „ axisX “ und „ axisY “ hinzu. Beispiel:

// lineSeries is a LineSeries object that has already been added to the ChartView; re-use its axes
var myAxisX = chartView.axisX(lineSeries);
var myAxisY = chartView.axisY(lineSeries);
var scatter = chartView.createSeries(ChartView.SeriesTypeScatter, "scatter series", myAxisX, myAxisY);

Die folgenden Aufzählungswerte können als Werte für ` type` verwendet werden:

bool isZoomed()

Gibt „ true “ zurück, wenn eine der Reihen einen gezoomten Definitionsbereich aufweist.

point mapToPosition(point value, AbstractSeries series)

Gibt die Position des Werts „ value “ in der Zeitreihe „ series “ im Diagramm zurück.

point mapToValue(point position, AbstractSeries series)

Gibt den Wert in der Reihe „ series “ zurück, der sich an der Position „ position “ im Diagramm befindet.

void removeAllSeries()

Entfernt alle Reihen aus dem Diagramm und löscht alle Reihenobjekte endgültig.

void removeSeries(AbstractSeries series)

Entfernt die Reihe „ series “ aus dem Diagramm und löscht das Reihenobjekt endgültig.

void scrollDown(real pixels)

Scrollt um die in ` pixels` angegebene Anzahl an Pixeln nach unten. Dies ist eine Komfortmethode, die sich beispielsweise für die Navigation mit Tasten eignet.

void scrollLeft(real pixels)

Blättert um die in ` pixels` angegebene Anzahl an Pixeln nach links. Dies ist eine Komfortmethode, die sich beispielsweise für die Navigation mit Tasten eignet.

void scrollRight(real pixels)

Blättert um die in ` pixels` angegebene Anzahl an Pixeln nach rechts. Dies ist eine Komfortmethode, die sich beispielsweise für die Navigation mit Tasten eignet.

void scrollUp(real pixels)

Blättert um die in ` pixels` angegebene Anzahl an Pixeln nach oben. Dies ist eine Komfortmethode, die sich beispielsweise für die Navigation mit Tasten eignet.

AbstractSeries series(int index)

Gibt die Reihe mit dem Index „ index “ im Diagramm zurück. In Verbindung mit der Eigenschaft „ count “ des Diagramms ermöglicht dies das Durchlaufen der Reihen eines Diagramms.

Siehe auch „ count “.

AbstractSeries series(string name)

Gibt die erste Reihe im Diagramm mit dem Namen „ name “ zurück. Wenn es keine Reihe mit diesem Namen gibt, wird „null“ zurückgegeben.

void setAxisX(AbstractAxis axis, AbstractSeries series)

Setzt die x-Achse des „ series “ auf „ axis “.

Siehe auch axisX().

void setAxisY(AbstractAxis axis, AbstractSeries series)

Setzt die y-Achse des „ series “ auf „ axis “.

Siehe auch axisY().

void zoom(real factor)

Vergrößert die Grafik um den benutzerdefinierten Faktor factor.

Ein Faktor über 1,0 vergrößert die Ansicht, ein Faktor zwischen 0,0 und 1,0 verkleinert sie.

void zoomIn()

Vergrößert die Ansicht um den Faktor zwei.

void zoomIn(rect rectangle)

Vergrößert die Ansicht auf die maximale Ebene, bei der das Rechteck rectangle noch vollständig sichtbar ist.

void zoomOut()

Verkleinert die Ansicht um den Faktor zwei.

void zoomReset()

Setzt die Seriendomänen auf den Stand zurück, den sie hatten, bevor eine Zoom-Methode aufgerufen wurde.