Back to Qt.io
Contact Us Blog Download Qt

Bars3D QML Type

3D-Balkendiagramm. Mehr...

Import Statement: import QtDataVisualization 1.8
Since: QtDataVisualization 1.0
Inherits:

AbstractGraph3D

Eigenschaften

Methoden

Detaillierte Beschreibung

Dieser Typ ermöglicht es Entwicklern, Balkendiagramme in 3D mit Qt Quick darzustellen.

Um diesen Typ zu verwenden, müssen Sie das Datenvisualisierungsmodul importieren:

import QtDataVisualization 1.2

Danach können Sie Bars3D in Ihren qml-Dateien verwenden:

import QtQuick 2.0
import QtDataVisualization 1.2

Item {
    width: 640
    height: 480

    Bars3D {
        width: parent.width
        height: parent.height

        Bar3DSeries {
            itemLabelFormat: "@colLabel, @rowLabel: @valueLabel"

            ItemModelBarDataProxy {
                itemModel: dataModel
                // Mapping model roles to bar series rows, columns, and values.
                rowRole: "year"
                columnRole: "city"
                valueRole: "expenses"
            }
        }
    }

    ListModel {
        id: dataModel
        ListElement{ year: "2012"; city: "Oulu";     expenses: "4200"; }
        ListElement{ year: "2012"; city: "Rauma";    expenses: "2100"; }
        ListElement{ year: "2012"; city: "Helsinki"; expenses: "7040"; }
        ListElement{ year: "2012"; city: "Tampere";  expenses: "4330"; }
        ListElement{ year: "2013"; city: "Oulu";     expenses: "3960"; }
        ListElement{ year: "2013"; city: "Rauma";    expenses: "1990"; }
        ListElement{ year: "2013"; city: "Helsinki"; expenses: "7230"; }
        ListElement{ year: "2013"; city: "Tampere";  expenses: "4650"; }
    }
}

Siehe Simple Bar Graph für ein ausführliches Anwendungsbeispiel.

Siehe auch Bar3DSeries, ItemModelBarDataProxy, Scatter3D, Surface3D, und Qt Data Visualization C++ Classes.

Dokumentation der Eigenschaften

barSeriesMargin : size [since 6.3]

Abstand zwischen den Spalten der Reihe in den Dimensionen X und Z. Standardmäßig auf (0.0, 0.0) voreingestellt. Sinnvolle Werte liegen im Bereich [0,1).

Diese Eigenschaft wurde in Qt 6.3 eingeführt.


barSpacing : size

Balkenabstand in der X- und Z-Dimension.

Standardmäßig auf (1.0, 1.0) voreingestellt. Die Abstände werden von der Eigenschaft barSpacingRelative beeinflusst.


barSpacingRelative : bool

Ob der Abstand absolut oder relativ zur Balkendicke ist.

Bei true bedeutet der Wert 0.0, dass die Balken nebeneinander platziert werden, 1.0 bedeutet, dass zwischen den Balken ein Abstand von der Dicke eines Balkens gelassen wird, und so weiter. Voreingestellt auf true.


barThickness : real

Das Verhältnis der Balkenstärke zwischen den Dimensionen X und Z. Der Wert 1.0 bedeutet, dass die Balken so breit wie tief sind, während 0.5 sie doppelt so tief wie breit macht.


columnAxis : CategoryAxis3D

Die aktive Spaltenachse.

Wenn keine Achse angegeben wird, wird eine temporäre Standardachse ohne Beschriftung erstellt. Diese temporäre Achse wird zerstört, wenn eine andere Achse explizit auf dieselbe Ausrichtung gesetzt wird.


floorLevel : real

Das Bodenniveau für das Balkendiagramm in Y-Achsen-Datenkoordinaten.

Die tatsächliche Bodenhöhe wird durch die Mindest- und Höchstwerte der Y-Achse begrenzt. Der Standardwert ist Null.


multiSeriesUniform : bool

Legt fest, ob die Balken mit Proportionen skaliert werden sollen, die auf einen einzelnen Serienbalken eingestellt sind, auch wenn mehrere Serien angezeigt werden. Bei der Einstellung true wird bar spacing nur auf die X-Achse korrekt angewendet. Standardmäßig auf false voreingestellt.


primarySeries : Bar3DSeries

Die primäre Reihe des Diagramms. Sie wird verwendet, um die Zeilen- und Spaltenachsenbeschriftungen zu bestimmen, wenn die Beschriftungen nicht explizit auf die Achsen gesetzt sind.

Wenn die angegebene Reihe noch nicht zum Diagramm hinzugefügt wurde, wird sie durch die Festlegung als primäre Reihe auch implizit zum Diagramm hinzugefügt.

Wenn die primäre Reihe selbst aus dem Diagramm entfernt wird, wird diese Eigenschaft auf den Standardwert zurückgesetzt.

Wenn die Serie null ist, wird diese Eigenschaft auf den Standardwert zurückgesetzt. Der Standardwert ist die erste hinzugefügte Reihe oder Null, wenn dem Diagramm keine Reihen hinzugefügt werden.


rowAxis : CategoryAxis3D

Die aktive Zeilenachse.

Wenn keine Achse angegeben wird, wird eine temporäre Standardachse ohne Beschriftung erstellt. Diese temporäre Achse wird zerstört, wenn eine andere Achse explizit auf dieselbe Ausrichtung gesetzt wird.


selectedSeries : Bar3DSeries

Die ausgewählte Reihe oder null. Wenn selectionMode das Flag SelectionMultiSeries gesetzt hat, enthält diese Eigenschaft die Reihe, die den ausgewählten Balken besitzt.


seriesList : list<Bar3DSeries> [default]

Die Serie des Diagramms. Standardmäßig enthält diese Eigenschaft eine leere Liste. Um die Serien festzulegen, verwenden Sie entweder die Funktion addSeries() oder definieren Sie sie als Kinder des Diagramms.


valueAxis : ValueAxis3D

Die aktive Wertachse.

Wenn keine Achse angegeben wird, wird eine temporäre Standardachse ohne Beschriftung und mit einem sich automatisch anpassenden Bereich erstellt. Diese temporäre Achse wird zerstört, wenn eine andere Achse explizit auf dieselbe Ausrichtung gesetzt wird.


Methode Dokumentation

void addSeries(Bar3DSeries series)

Fügt die series zum Diagramm hinzu. Ein Diagramm kann mehrere Reihen enthalten, aber nur einen Satz von Achsen, so dass die Zeilen und Spalten aller Reihen übereinstimmen müssen, damit die visualisierten Daten aussagekräftig sind. Wenn das Diagramm mehrere sichtbare Reihen enthält, erzeugt nur die erste hinzugefügte Reihe die Zeilen- oder Spaltenbeschriftungen auf den Achsen, wenn die Beschriftungen nicht explizit für die Achsen festgelegt wurden. Wenn für die neu hinzugefügte Reihe ein ausgewählter Balken angegeben wurde, wird dieser hervorgehoben, und eine vorhandene Auswahl wird gelöscht. Nur eine hinzugefügte Reihe kann eine aktive Auswahl haben.

Siehe auch AbstractGraph3D::hasSeries().


void insertSeries(int index, Bar3DSeries series)

Fügt series an der Position index in die Serienliste ein. Wenn die Serie series bereits zur Liste hinzugefügt wurde, wird sie an die neue Position index verschoben.

Hinweis: Wenn eine Reihe an eine neue index verschoben wird, die nach ihrem alten Index liegt, wird die neue Position in der Liste so berechnet, als befände sich die Reihe noch an ihrem alten Index, so dass der endgültige Index tatsächlich der um eins verminderte index ist.

Siehe auch AbstractGraph3D::hasSeries().


void removeSeries(Bar3DSeries series)

Entfernt die series aus dem Diagramm.

Siehe auch AbstractGraph3D::hasSeries().


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.