ChartView QML Type

Verwaltet die grafische Darstellung der Serien, Legenden und Achsen des Diagramms. Mehr...

• 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()

Detaillierte Beschreibung

Der Typ ChartView zeigt verschiedene Serientypen als Diagramme an.

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 der Eigenschaften

animationDuration : int

Die Dauer der Animation für das Diagramm.

animationEasingCurve : easing

Die Entspannungskurve 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 Hintergrunds des Diagramms. Standardmäßig wird die Hintergrundfarbe durch das Diagrammthema festgelegt.

Siehe auch theme.

backgroundRoundness : real

Der Durchmesser des Abrundungskreises an den Ecken des Diagrammhintergrunds.

count : int

Die Anzahl der dem Diagramm hinzugefügten Serien.

dropShadowEnabled : bool

Gibt an, ob der Schlagschatteneffekt im Hintergrund aktiviert ist.

Bei der Einstellung true ist der Hintergrundschatteneffekt aktiviert. Wenn er auf false gesetzt ist, ist er deaktiviert.

legend : Legend

Die Legende des Diagramms. In der Legende werden alle dem Diagramm hinzugefügten Serien, Tortenstücke und Balkensätze aufgeführt.

locale : locale [since QtCharts 2.0]

Das Gebietsschema, das für die Formatierung verschiedener Diagrammbeschriftungen verwendet wird.

Beschriftungen werden nur lokalisiert, wenn localizeNumbers true ist, mit Ausnahme von DateTimeAxis Beschriftungen, die immer die mit dieser Eigenschaft eingestellte QLocale verwenden.

Die Standardeinstellung ist das Standardgebietsschema der Anwendung, wenn das Diagramm erstellt wird.

Diese Eigenschaft wurde in QtCharts 2.0 eingeführt.

Siehe auch localizeNumbers.

localizeNumbers : bool [since QtCharts 2.0]

Ob Zahlen lokalisiert werden.

Wenn true gewählt wird, werden alle generierten Zahlen, die in verschiedenen Serien und Achsenbeschriftungen erscheinen, unter Verwendung der QLocale mit der Eigenschaft locale lokalisiert. Wenn false, wird immer das Gebietsschema C verwendet. Die Voreinstellung ist false.

Diese Eigenschaft wurde in QtCharts 2.0 eingeführt.

Siehe auch locale.

margins : Margins

Die minimal zulässigen Ränder zwischen dem Rand des Diagrammrechtecks und dem Plotbereich. Die Ränder werden zum Zeichnen des Titels, der Achsen und der Legende verwendet.

plotArea : rect

Das Rechteck, innerhalb dessen das Diagramm gezeichnet wird.

Der Darstellungsbereich umfasst nicht den durch Ränder definierten Bereich. Standardmäßig wird die Größe angepasst, wenn er sich innerhalb eines ChartView befindet. Wenn ein explizites Rechteck für den Darstellungsbereich festgelegt ist, wird dies beachtet; um zum Standardverhalten zurückzukehren, wird dies durch die Einstellung Qt.rect(0, 0, 0, 0) erreicht.

Siehe auch margins.

plotAreaColor : color

Die Farbe des Hintergrunds des Diagrammbereichs. Standardmäßig verwendet der Hintergrund des Diagrammbereichs die Hintergrundfarbe des Diagramms, die durch das Diagrammthema festgelegt ist.

Siehe auch backgroundColor und theme.

theme : enumeration

Das von dem Diagramm verwendete Thema.

Ein Thema ist eine integrierte Sammlung von UI-Stil-bezogenen Einstellungen, die auf alle visuellen Elemente eines Diagramms angewendet werden, wie z. B. Farben, Stifte, Pinsel und Schriftarten von Reihen, sowie Achsen, Titel und Legende. Das Beispiel Qml Oszilloskop veranschaulicht, wie man ein Thema festlegt.

Die folgenden Werte werden unterstützt:

title : string

Der Titel wird als Überschrift am oberen Rand des Diagramms angezeigt. Diagrammtitel unterstützen die HTML-Formatierung.

Siehe auch titleColor.

titleColor : color

Die Farbe des Titeltextes.

titleFont : font

Die Titelschriftart des Diagramms.

Weitere Informationen finden Sie unter font.

Signal-Dokumentation

seriesAdded(AbstractSeries series)

Dieses Signal wird ausgegeben, wenn die Serie series zum Diagramm hinzugefügt wird.

seriesRemoved(AbstractSeries series)

Dieses Signal wird ausgegeben, wenn die Serie series aus dem Diagramm entfernt wird. Das Serienobjekt wird ungültig, wenn der Signalhandler abgeschlossen ist.

Dokumentation der Methode

Axis axisX(AbstractSeries series)

Die x-Achse der series.

Siehe auch setAxisX().

Axis axisY(AbstractSeries series)

Die y-Achse der series.

Siehe auch setAxisY().

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

Fügt dem Diagramm eine Reihe des Typs type mit dem Namen name und, optional, den Achsen axisX und axisY hinzu. Ein 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 von type verwendet werden:

bool isZoomed()

Gibt true zurück, wenn eine Reihe einen gezoomten Bereich hat.

point mapToPosition(point value, AbstractSeries series)

Gibt die Position des Wertes value in der Reihe 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 Serien aus dem Diagramm und löscht alle Serienobjekte dauerhaft.

void removeSeries(AbstractSeries series)

Entfernt die Serie series aus dem Diagramm und löscht das Serienobjekt dauerhaft.

void scrollDown(real pixels)

Scrollt um die durch pixels angegebene Anzahl von Pixeln nach unten. Dies ist eine bequeme Methode, die sich z. B. für die Tastaturnavigation eignet.

void scrollLeft(real pixels)

Scrollt um die in pixels angegebene Anzahl von Pixeln nach links. Dies ist eine bequeme Methode, die sich z. B. für die Tastaturnavigation eignet.

void scrollRight(real pixels)

Scrollt um die in pixels angegebene Anzahl von Pixeln nach rechts. Dies ist eine bequeme Methode, die sich z. B. für die Tastaturnavigation eignet.

void scrollUp(real pixels)

Scrollt um die in pixels angegebene Anzahl von Pixeln nach oben. Dies ist eine bequeme Methode, die sich z. B. für die Tastaturnavigation eignet.

AbstractSeries series(int index)

Gibt die Serie mit dem Index index im Diagramm zurück. Zusammen mit der Eigenschaft count des Diagramms ermöglicht dies eine Schleifenbildung durch die Serien 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 von series auf axis.

Siehe auch axisX().

void setAxisY(AbstractAxis axis, AbstractSeries series)

Setzt die y-Achse von series auf axis.

Siehe auch axisY().

void zoom(real factor)

Vergrößert das Diagramm um den benutzerdefinierten Faktor factor.

Mit einem Faktor über 1,0 wird in die Ansicht hineingezoomt und mit einem Faktor zwischen 0,0 und 1,0 aus ihr herausgezoomt.

void zoomIn()

Vergrößert die Ansicht um den Faktor zwei.

void zoomIn(rect rectangle)

Vergrößert die Ansicht bis zu einer maximalen Höhe, bei der das Rechteck rectangle noch vollständig sichtbar ist.

void zoomOut()

Verkleinert die Ansicht um den Faktor zwei.

void zoomReset()

Setzt die Bereiche der Reihe auf den Stand vor dem Aufruf einer Zoom-Methode zurück.