Bars3D QML Type

3D-Balkendiagramm. Mehr...

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• barSeriesMargin : size (since 6.3)
• barSpacing : size
• barSpacingRelative : bool
• barThickness : real
• columnAxis : CategoryAxis3D
• floorLevel : real
• multiSeriesUniform : bool
• primarySeries : Bar3DSeries
• rowAxis : CategoryAxis3D
• selectedSeries : Bar3DSeries
• seriesList : list<Bar3DSeries>
• valueAxis : ValueAxis3D

Methoden

• void addSeries(Bar3DSeries series)
• void insertSeries(int index, Bar3DSeries series)
• void removeSeries(Bar3DSeries series)

Ausführliche 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

Anschließend 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"; }
    }
}

Ein ausführlicheres Anwendungsbeispiel finden Sie unter „Einfaches Balkendiagramm “.

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

Dokumentation zu den Eigenschaften

barSeriesMargin : size [since 6.3]

Abstand zwischen den Spalten einer Reihe in der X- und Z-Richtung. 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

Stababstand in den X- und Z-Achsen.

Standardmäßig auf „ (1.0, 1.0) “ voreingestellt. Der Abstand wird durch die Eigenschaft „ barSpacingRelative “ beeinflusst.

barSpacingRelative : bool

Ob der Abstand absolut oder relativ zur Balkenstärke ist.

Wenn „ true “ gesetzt ist, bedeutet der Wert „ 0.0 “, dass die Balken nebeneinander platziert werden, „ 1.0 “ bedeutet, dass zwischen den Balken ein Abstand in der Breite einer Balkenstärke gelassen wird, und so weiter. Voreinstellung: „ true “.

barThickness : real

Das Verhältnis der Stabdicke zwischen den Abmessungen X und Z. Der Wert „ 1.0 “ bedeutet, dass die Stäbe genauso breit wie tief sind, während „ 0.5 “ bedeutet, dass sie doppelt so tief wie breit sind.

columnAxis : CategoryAxis3D

Die aktive Spaltenachse.

Wird keine Achse angegeben, wird eine temporäre Standardachse ohne Beschriftungen erstellt. Diese temporäre Achse wird gelöscht, wenn eine andere Achse explizit auf dieselbe Ausrichtung gesetzt wird.

floorLevel : real

Die Untergrenze für das Balkendiagramm in den Datenkoordinaten der Y-Achse.

Die tatsächliche Untergrenze wird durch die Minimal- und Maximalwerte der Y-Achse begrenzt. Der Standardwert ist Null.

multiSeriesUniform : bool

Legt fest, ob die Balken anhand der Proportionen eines einzelnen Serienbalkens skaliert werden sollen, auch wenn mehrere Serien angezeigt werden. Bei der Einstellung „ true “ wird „ bar spacing “ nur auf die X-Achse korrekt angewendet. Standardmäßig ist „ false “ voreingestellt.

primarySeries : Bar3DSeries

Die primäre Reihe des Diagramms. Sie dient zur Bestimmung der Beschriftungen der Zeilen- und Spaltenachsen, wenn diese nicht explizit für die Achsen festgelegt wurden.

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

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

Ist die Reihe null, wird diese Eigenschaft auf den Standardwert zurückgesetzt. Der Standardwert ist die zuerst hinzugefügte Reihe oder Null, wenn dem Diagramm keine Reihen hinzugefügt wurden.

rowAxis : CategoryAxis3D

Die aktive Zeilenachse.

Wird keine Achse angegeben, wird eine temporäre Standardachse ohne Beschriftungen erstellt. Diese temporäre Achse wird gelöscht, wenn eine andere Achse explizit auf dieselbe Ausrichtung gesetzt wird.

selectedSeries : Bar3DSeries

Die ausgewählte Serie oder null. Wenn für selectionMode das Flag „ SelectionMultiSeries “ gesetzt ist, enthält diese Eigenschaft die Serie, zu der der ausgewählte Balken gehört.

seriesList : list<Bar3DSeries> [default]

Die Reihen des Diagramms. Standardmäßig enthält diese Eigenschaft eine leere Liste. Um die Reihen festzulegen, verwenden Sie entweder die Funktion „ addSeries()“ oder definieren Sie sie als untergeordnete Elemente des Diagramms.

valueAxis : ValueAxis3D

Die aktive Werteachse.

Wird keine Achse angegeben, wird eine temporäre Standardachse ohne Beschriftungen und mit einem sich automatisch anpassenden Bereich erstellt. Diese temporäre Achse wird gelöscht, wenn eine andere Achse explizit mit derselben Ausrichtung festgelegt wird.

Methodendokumentation

void addSeries(Bar3DSeries series)

Fügt die Reihe „ series “ zum Diagramm hinzu. Ein Diagramm kann mehrere Reihen enthalten, jedoch nur einen Achsenpaar, sodass 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 zuerst hinzugefügte Reihe die Zeilen- oder Spaltenbeschriftungen auf den Achsen, sofern diese nicht explizit für die Achsen festgelegt wurden. Wenn für die neu hinzugefügte Reihe ein Balken ausgewählt wurde, wird dieser hervorgehoben und eine eventuell vorhandene Auswahl wird aufgehoben. Nur eine der hinzugefügten Reihen kann eine aktive Auswahl haben.

Siehe auch ` AbstractGraph3D::hasSeries()`.

void insertSeries(int index, Bar3DSeries series)

Fügt den „ series “ an der Position „ index “ in die Serienliste ein. Falls der „ series “ bereits zur Liste hinzugefügt wurde, wird er an die neue Position „ index “ verschoben.

Siehe auch AbstractGraph3D::hasSeries().

void removeSeries(Bar3DSeries series)

Entfernen Sie den Knoten „ series “ aus dem Graphen.

Siehe auch „ AbstractGraph3D::hasSeries()“.