Back to Qt.io
Contact Us Blog Download Qt

Bars3D QML Type

3D-Balkendiagramm. Mehr...

Import Statement: import QtGraphs
Inherits:

GraphsItem3D

Eigenschaften

Signale

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 Modul Qt Graphs importieren:

import QtGraphs

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

import QtQuick
import QtGraphs

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: "2022"; city: "Oulu";     expenses: "4200"; }
        ListElement{ year: "2022"; city: "Rauma";    expenses: "2100"; }
        ListElement{ year: "2022"; city: "Helsinki"; expenses: "7040"; }
        ListElement{ year: "2022"; city: "Tampere";  expenses: "4330"; }
        ListElement{ year: "2023"; city: "Oulu";     expenses: "3960"; }
        ListElement{ year: "2023"; city: "Rauma";    expenses: "1990"; }
        ListElement{ year: "2023"; city: "Helsinki"; expenses: "7230"; }
        ListElement{ year: "2023"; city: "Tampere";  expenses: "4650"; }
    }
}

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

Siehe auch Bar3DSeries, ItemModelBarDataProxy, Scatter3D, Surface3D, und Qt Graphs C++ Klassen für 3D.

Dokumentation der Eigenschaften

ambientLightStrength : real

Die Umgebungslichtstärke für das gesamte Diagramm. Dieser Wert bestimmt, wie gleichmäßig und hell die Farben im gesamten Diagramm unabhängig von der Lichtposition dargestellt werden. Der Wert muss zwischen 0.0 und 1.0 liegen.


aspectRatio : real

Das Verhältnis der Skalierung des Diagramms zwischen der längsten Achse auf der horizontalen Ebene und der y-Achse. Der Standardwert ist 2.0.

Hinweis: Hat keine Auswirkung auf Bars3D.

Siehe auch horizontalAspectRatio.


barSeriesMargin : size

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].


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.


cameraPreset : Graphs3D.CameraPreset

Die derzeit aktive Kameravoreinstellung, die eine von Graphs3D.CameraPreset ist. Ist keine Voreinstellung aktiv, lautet der Wert Graphs3D.CameraPreset.NoPreset.


cameraTargetPosition : vector3d

Das Kameraziel in Form eines vector3d. Der Standardwert ist vector3d(0.0, 0.0, 0.0).

Gültige Koordinatenwerte liegen zwischen -1.0...1.0, wobei die Randwerte die Ränder des entsprechenden Achsenbereichs angeben. Alle Werte außerhalb dieses Bereichs werden an den Rand geklemmt.


cameraXRotation : float

Der X-Drehwinkel der Kamera um den Zielpunkt in Grad, ausgehend von der aktuellen Basisposition.


cameraYRotation : float

Der Y-Drehwinkel der Kamera um den Zielpunkt in Grad, ausgehend von der aktuellen Basisposition.


cameraZoomLevel : float

Die Zoomstufe der Kamera in Prozent. Der Standardwert 100.0 bedeutet, dass die Kamera nicht vergrößert oder verkleinert werden kann. Der Wert wird durch die Eigenschaften minCameraZoomLevel und maxCameraZoomLevel begrenzt.

Siehe auch minCameraZoomLevel und maxCameraZoomLevel.


columnAxis : Category3DAxis

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.


currentFps : int

Wenn die FPS-Messung aktiviert ist, werden die Ergebnisse der letzten Sekunde in dieser schreibgeschützten Eigenschaft gespeichert. Es dauert mindestens eine Sekunde, bis dieser Wert nach der Aktivierung der Messung aktualisiert wird.

Siehe auch measureFps.


customItemList : list<Custom3DItem>

Die Liste der Custom3DItem Elemente, die dem Diagramm hinzugefügt wurden. Das Diagramm übernimmt das Eigentum an den hinzugefügten Elementen.


floorLevel : real

Die Bodenhöhe für das Balkendiagramm in Datenkoordinaten der Y-Achse.

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


gridLineType : Graphs3D.GridLineType

Legt fest, ob der Typ der Gitterlinien Graphs3D.GridLineType.Shader oder Graphs3D.GridLineType.Geometry ist.

Dieser Wert wirkt sich auf alle Rasterlinien aus.

Siehe auch Graphs3D.GridLineType.


horizontalAspectRatio : real

Das Verhältnis der Skalierung des Diagramms zwischen der x-Achse und der z-Achse. Der Wert 0.0 bedeutet eine automatische Skalierung entsprechend den Achsenbereichen. Der Standardwert ist 0.0.

Hinweis: Hat keine Auswirkung auf Bars3D, das die Skalierung auf der horizontalen Ebene über die Eigenschaften barThickness und barSpacing handhabt. Polardiagramme ignorieren diese Eigenschaft ebenfalls.

Siehe auch aspectRatio, polar, Bars3D::barThickness, und Bars3D::barSpacing.


labelMargin : real

Diese Eigenschaft legt den Rand für die Platzierung der Achsenbeschriftungen fest.

Negative Werte platzieren die Beschriftungen innerhalb des Plot-Bereichs, positive Werte außerhalb des Plot-Bereichs. Die automatische Drehung der Beschriftungen ist deaktiviert, wenn der Wert negativ ist. Standardwert ist 0.1

Siehe auch QAbstract3DAxis::labelAutoAngle.


lightColor : color

Die Farbe des Umgebungs- und Glanzlichts, definiert in Scene3D.


lightStrength : real

Die Stärke des Glanzlichts für das gesamte Diagramm. Der Wert muss zwischen 0.0 und 10.0 liegen.

Dieser Wert wirkt sich auf das in Scene3D angegebene Licht aus.


locale : locale

Legt das Gebietsschema fest, das für die Formatierung verschiedener numerischer Beschriftungen verwendet wird. Standardmäßig wird das Gebietsschema "C" verwendet.

Siehe auch Value3DAxis::labelFormat.


margin : real

Der absolute Wert, der für den Abstand zwischen dem Rand des plottbaren Diagrammbereichs und dem Rand des Diagrammhintergrunds verwendet wird.

Wenn der Wert für den Rand negativ ist, werden die Ränder automatisch bestimmt und können je nach Größe der Elemente in der Reihe und dem Typ des Diagramms variieren. Der Wert wird als Bruchteil des y-Achsenbereichs interpretiert, wenn die Seitenverhältnisse des Diagramms gegenüber den Standardwerten nicht geändert wurden. Der Standardwert ist -1.0.

Hinweis: Wird für ein Streudiagramm ein kleinerer Rand als der automatisch ermittelte Rand eingestellt, kann dies dazu führen, dass sich die Streuelemente an den Rändern des Diagramms mit dem Diagrammhintergrund überlappen.

Hinweis: Wenn bei Streu- und Oberflächendiagrammen der Rand im Vergleich zur Größe der Achsenbeschriftung klein ist, werden die Positionen der Randbeschriftungen der Achsen angepasst, um eine Überlappung mit den Randbeschriftungen der benachbarten Achsen zu vermeiden.


maxCameraZoomLevel : float

Legt die maximal zulässige Zoomstufe der Kamera fest. Wenn die neue maximale Stufe niedriger ist als die vorhandene minimale Stufe, wird die minimale Stufe ebenfalls an die neue maximale Stufe angepasst. Wenn die aktuelle cameraZoomLevel außerhalb der neuen Grenzen liegt, wird sie ebenfalls angepasst. Die Standardeinstellung ist 500.0f.

Siehe auch cameraZoomLevel und minCameraZoomLevel.


measureFps : bool

Falls true, wird das Rendering kontinuierlich und nicht nur bei Bedarf durchgeführt und der Wert der Eigenschaft currentFps aktualisiert. Der Standardwert ist false.

Siehe auch currentFps.


minCameraZoomLevel : float

Legt die minimal zulässige Zoomstufe der Kamera fest. Wenn die neue Mindeststufe höher ist als die vorhandene Höchststufe, wird die Höchststufe ebenfalls an die neue Mindeststufe angepasst. Wenn die aktuelle cameraZoomLevel außerhalb der neuen Grenzen liegt, wird sie ebenfalls angepasst. Der minCameraZoomLevel kann nicht unter 1.0 gesetzt werden. Der Standardwert ist 10.0.

Siehe auch cameraZoomLevel und maxCameraZoomLevel.


msaaSamples : int

Die Anzahl der Samples, die beim Multisample-Antialiasing verwendet werden, wenn renderingMode für Indirect steht. Wenn renderingMode gleich DirectToBackground ist, ist dieser Eigenschaftswert schreibgeschützt und gibt die Anzahl der Samples zurück, die durch das Fensteroberflächenformat festgelegt ist. Der Standardwert ist 4.

Siehe auch renderingMode.


multiSeriesUniform : bool

Legt fest, ob Balken mit Proportionen skaliert werden sollen, die auf einen einzelnen Serienbalken festgelegt 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.


optimizationHint : Graphs3D.OptimizationHint

Gibt an, ob der Standard- oder Legacy-Modus für die Rendering-Optimierung verwendet wird.

Der Standardmodus verwendet instanziertes Rendering und bietet den vollen Funktionsumfang bei bester Leistung auf den meisten Systemen. Der statische Modus optimiert das Rendering von Diagrammen und ist ideal für große, sich nicht verändernde Datensätze. Bei dynamischen Datenänderungen und Elementdrehungen ist er langsamer. Die Auswahl wird nicht optimiert, daher ist die Verwendung des statischen Modus bei großen Datensätzen nicht ratsam. Der Legacy-Modus rendert alle Elemente im Diagramm einzeln, ohne Instanzierung. Er sollte nur verwendet werden, wenn der Standardmodus nicht funktioniert, d. h. wenn das Zielsystem keine Instanzierung unterstützt. Die Voreinstellung ist Default.

Hinweis: In manchen Umgebungen können große Graphen mit statischer Optimierung nicht gerendert werden, da alle Elemente mit einem einzigen Zeichenaufruf gerendert werden und verschiedene Grafiktreiber unterschiedliche maximale Anzahlen von Vertices pro Aufruf unterstützen. Dies ist vor allem ein Problem auf 32bit- und OpenGL ES2-Plattformen. Um dieses Problem zu umgehen, wählen Sie ein Objektmesh mit einer niedrigen Vertexanzahl oder verwenden Sie das Punktmesh.

Siehe auch Abstract3DSeries::mesh und Graphs3D.OptimizationHint.


orthoProjection : bool

Wenn true gewählt wird, wird die orthografische Projektion für die Darstellung des Diagramms verwendet. Die Standardeinstellung ist false.

Hinweis: Bei der Einstellung true werden die Schatten deaktiviert.


polar : bool

Wenn true eingestellt ist, werden die horizontalen Achsen in polare Achsen umgewandelt. Die x-Achse wird zur Winkelachse und die z-Achse wird zur Radialachse. Der Polarmodus ist für Balkendiagramme nicht verfügbar.

Die Standardeinstellung ist false.

Siehe auch orthoProjection und radialLabelOffset.


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 werden.

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 wurden.


queriedGraphPosition : vector3d [read-only]

Diese schreibgeschützte Eigenschaft enthält die letzten Positionswerte des Diagramms entlang jeder Achse, die mit Scene3D::graphPositionQuery abgefragt wurden. Die Werte sind auf den Bereich [-1, 1] normalisiert. Wenn die abgefragte Position außerhalb der Diagrammgrenzen lag, spiegeln die Werte nicht die tatsächliche Position wider, sondern eine undefinierte Position außerhalb des Bereichs [-1, 1]. Der Wert ist so lange undefiniert, bis eine Abfrage durchgeführt wird.

Es gibt keine einzige korrekte 3D-Koordinate, die einer bestimmten Bildschirmposition entspricht. Um konsistent zu sein, werden die Abfragen daher immer an den Innenseiten eines unsichtbaren Rahmens durchgeführt, der das Diagramm umgibt.

Hinweis: Bei Balkendiagrammen ist die Abfrage der Diagrammposition nur auf der Ebene des Diagrammbodens möglich, so dass der y-Wert bei Balkendiagrammen immer Null ist und gültige Abfragen nur an Bildschirmpositionen erfolgen können, die den Boden des Diagramms enthalten.

Siehe auch Scene3D::graphPositionQuery.


radialLabelOffset : real

Diese Eigenschaft gibt den normierten horizontalen Versatz für die Achsenbeschriftungen der radialen Polarachse an. Der Wert 0.0 gibt an, dass die Beschriftungen neben der 0-Winkel-Winkelachsen-Gitterlinie gezeichnet werden sollen. Der Wert 1.0 gibt an, dass die Beschriftungen an ihrem üblichen Platz am Rand des Diagrammhintergrunds gezeichnet werden. Diese Eigenschaft wird ignoriert, wenn der Wert der Polareigenschaft false lautet. Der Standardwert ist 1.0.

Siehe auch polar.


renderingMode : Graphs3D.RenderingMode

Wie das Diagramm gerendert werden soll. Der Standardwert ist Indirect.

Hinweis: Die Einstellung der Eigenschaft antialiasing des Diagramms hat keine Auswirkungen. Sie wird jedoch von der Grafik selbst gesetzt, wenn der aktuelle Rendering-Modus Antialiasing verwendet.

Siehe auch msaaSamples und Graphs3D.RenderingMode.


rotationEnabled : bool

Ob dieser Input-Handler eine Drehung des Graphen erlaubt.

Der Standardwert ist true.


rowAxis : Category3DAxis

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.


scene : Scene3D [read-only]

Der Zeiger Scene3D, mit dem die Szene manipuliert und auf die Szenenelemente zugegriffen werden kann.

Diese Eigenschaft ist schreibgeschützt.


selectedElement : Graphs3D.ElementType [read-only]

Das im Diagramm ausgewählte Element.

Diese Eigenschaft kann verwendet werden, um den Typ des ausgewählten Elements abzufragen. Der Typ ist so lange gültig, bis eine neue Auswahl im Graphen getroffen und das Signal selectedElementChanged ausgegeben wird.

Das Signal kann z. B. zur Implementierung einer benutzerdefinierten Eingabebehandlung verwendet werden, wie im Beispiel Achsenbehandlung gezeigt.

Siehe auch selectedLabelIndex(), selectedAxis(), selectedCustomItemIndex(), selectedCustomItem(), Bars3D::selectedSeries, Scatter3D::selectedSeries, Scene3D::selectionQueryPosition, und Graphs3D.ElementType.


selectedSeries : Bar3DSeries [read-only]

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


selectionEnabled : bool

Ob dieser Input-Handler eine Auswahl aus dem Diagramm erlaubt.

Der Standardwert ist true.


selectionMode : Graphs3D.SelectionMode

Der aktive Auswahlmodus im Diagramm. Einer der Graphs3D.SelectionFlag enum Werte.


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.


shadowQuality : Graphs3D.ShadowQuality

Die Qualität des Schattens. Einer der Graphs3D.ShadowQuality enum-Werte.


shadowStrength : real

Die Stärke des Schattens für das gesamte Diagramm. Je höher der Wert, desto dunkler sind die Schatten. Der Wert muss zwischen 0.0 und 100.0 liegen.

Dieser Wert wirkt sich auf das in Scene3D angegebene Licht aus.


theme : GraphsTheme

Das aktive Thema des Diagramms.

Siehe auch GraphsTheme.


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.


wrapCameraXRotation : bool

Das Verhalten der minimalen und maximalen Grenzen in der X-Drehung. Standardmäßig verläuft die X-Drehung vom Minimalwert zum Maximum und vom Maximum zum Minimum.

Bei der Einstellung true wird die X-Drehung der Kamera vom Minimum zum Maximum und vom Maximum zum Minimum umgeschlagen. Bei der Einstellung false ist die X-Drehung der Kamera auf den durch den Minimal- und Maximalwert bestimmten Sektor begrenzt.


wrapCameraYRotation : bool

Das Verhalten der Minimal- und Maximalwerte bei der Y-Drehung. Standardmäßig wird die Y-Drehung zwischen dem Minimal- und dem Maximalwert begrenzt, ohne dass ein Umbruch stattfindet.

Wenn true angegeben ist, wird die Y-Drehung der Kamera vom Minimum zum Maximum und vom Maximum zum Minimum umbrochen. Wenn false, wird die Y-Drehung der Kamera auf den durch den Minimal- und Maximalwert bestimmten Sektor begrenzt.


zoomAtTargetEnabled : bool

Ob beim Zoomen das Kameraziel so verändert werden soll, dass der gezoomte Punkt des Graphen nach dem Zoomen an der gleichen Stelle bleibt.

Die Voreinstellung ist true.


zoomEnabled : bool

Ob dieser Input-Handler das Zoomen des Graphen erlaubt.

Der Standardwert ist true.


Signal Dokumentation

barSeriesMarginChanged(size margin)

Dieses Signal wird ausgegeben, wenn barSeriesMargin zu margin wechselt.

Hinweis: Der entsprechende Handler ist onBarSeriesMarginChanged.


barSpacingChanged(size spacing)

Dieses Signal wird ausgegeben, wenn barSpacing zu spacing wechselt.

Hinweis: Der entsprechende Handler ist onBarSpacingChanged.


barSpacingRelativeChanged(bool relative)

Dieses Signal wird ausgegeben, wenn barSpacingRelative zu relative wechselt.

Hinweis: Der entsprechende Handler ist onBarSpacingRelativeChanged.


barThicknessChanged(real thicknessRatio)

Dieses Signal wird ausgegeben, wenn barThickness zu thicknessRatio wechselt.

Hinweis: Der entsprechende Handler ist onBarThicknessChanged.


columnAxisChanged(Category3DAxis axis)

Dieses Signal wird ausgegeben, wenn columnAxis zu axis wechselt.

Hinweis: Der entsprechende Handler ist onColumnAxisChanged.


doubleTapped(QEventPoint eventPoint, Qt::MouseButton button)

Dieses Signal wird ausgegeben, wenn das Diagrammelement innerhalb einer kurzen Zeitspanne zweimal angetippt wird. Der Signalparameter eventPoint enthält Informationen aus dem Release-Ereignis über den Punkt, der angetippt wurde, und button ist der mouse button, der angeklickt wurde, oder NoButton auf einem Touchscreen.

Hinweis: Der entsprechende Handler ist onDoubleTapped.

Siehe auch QEventPoint, Qt::MouseButtons, und TapHandler::doubleTapped.


dragged(QVector2D delta)

Dieses Signal wird ausgegeben, wenn sich die Verschiebung des Punktclusters auf dem Graphen während der Ausführung der Pinch-Geste ändert. Der delta Vektor gibt die Änderung der Verschiebung an.

Hinweis: Der entsprechende Handler ist onDragged.

Siehe auch PinchHandler::translationChanged.


floorLevelChanged(real level)

Dieses Signal wird ausgegeben, wenn floorLevel zu level wechselt.

Hinweis: Der entsprechende Handler ist onFloorLevelChanged.


longPressed()

Dieses Signal wird ausgegeben, wenn das Element parent gedrückt und länger als TapHandler::longPressThreshold gehalten wird.

Hinweis: Der entsprechende Handler ist onLongPressed.

Siehe auch TapHandler::longPressed.


mouseMove(QPoint mousePos)

Dieses Signal wird ausgegeben, wenn der Graph ein MouseMove-Ereignis empfängt. mousePos Wert gibt die Position der Maus an, während sie sich bewegt.

Hinweis: Der entsprechende Handler ist onMouseMove.

Siehe auch QQuickItem::mouseMoveEvent.


multiSeriesUniformChanged(bool uniform)

Dieses Signal wird ausgegeben, wenn multiSeriesUniform zu uniform wechselt.

Hinweis: Der entsprechende Handler ist onMultiSeriesUniformChanged.


pinch(qreal delta)

Dieses Signal wird ausgegeben, wenn sich der Skalierungsfaktor in der Grafik ändert, während die Pinch-Geste ausgeführt wird. Der Wert delta gibt die multiplikative Änderung des Maßstabs an.

Hinweis: Der entsprechende Handler ist onPinch.

Siehe auch PinchHandler::scaleChanged.


primarySeriesChanged(Bar3DSeries series)

Dieses Signal wird ausgegeben, wenn primarySeries zu series wechselt.

Hinweis: Der entsprechende Handler ist onPrimarySeriesChanged.


rowAxisChanged(Category3DAxis axis)

Dieses Signal wird ausgegeben, wenn rowAxis zu axis wechselt.

Hinweis: Der entsprechende Handler ist onRowAxisChanged.


selectedSeriesChanged(Bar3DSeries series)

Dieses Signal wird ausgegeben, wenn selectedSeries zu series wechselt.

Hinweis: Der entsprechende Handler ist onSelectedSeriesChanged.


tapped(QEventPoint eventPoint, Qt::MouseButton button)

Dieses Signal wird ausgegeben, wenn das Diagrammelement einmal angetippt wird. Der Signalparameter eventPoint enthält Informationen aus dem Release-Ereignis über den Punkt, der angetippt wurde, und button ist der mouse button, der angeklickt wurde, oder NoButton auf einem Touchscreen.

Hinweis: Der entsprechende Handler ist onTapped.

Siehe auch QEventPoint, Qt::MouseButtons, und TapHandler::singleTapped.


valueAxisChanged(ValueAxis3D axis)

Dieses Signal wird ausgegeben, wenn valueAxis zu axis wechselt.

Hinweis: Der entsprechende Handler ist onValueAxisChanged.


wheel(QQuickWheelEvent *event)

Dieses Signal wird jedes Mal ausgegeben, wenn der Graph ein event vom Typ QWheelEvent empfängt, d.h. jedes Mal, wenn das Rad bewegt oder die Bildlaufgeste aktualisiert wird.

Hinweis: Der entsprechende Handler ist onWheel.

Siehe auch WheelEvent und WheelHandler::wheel.


Methode Dokumentation

qsizetype addCustomItem(Custom3DItem item)

Fügt ein Custom3DItem item zum Graph hinzu. Graph übernimmt das Eigentum an dem hinzugefügten Element.

Gibt den Index des hinzugefügten Elements zurück, wenn add erfolgreich war, -1, wenn versucht wurde, ein Nullelement hinzuzufügen, und den Index des Elements, wenn versucht wurde, ein bereits hinzugefügtes Element hinzuzufügen.

Siehe auch removeCustomItems(), removeCustomItem(), und removeCustomItemAt().


void addSeries(Bar3DSeries series)

Fügt dem Diagramm die series hinzu. Ein Diagramm kann mehrere Reihen enthalten, aber nur einen Achsensatz, so dass die Zeilen und Spalten aller Reihen übereinstimmen müssen, damit die visualisierten Daten sinnvoll 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 GraphsItem3D::hasSeries().


void clearSelection()

Löscht die Auswahl aus allen hinzugefügten Reihen.


bool hasSeries(Abstract3DSeries series)

Gibt zurück, ob der series bereits zum Diagramm hinzugefügt wurde.


void insertSeries(int index, Bar3DSeries series)

Fügt die Serie series an der Position index in der 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 GraphsItem3D::hasSeries().


void releaseCustomItem(Custom3DItem item)

Holt das Eigentum an item zurück und entfernt item aus dem Diagramm.

Hinweis: Wenn dasselbe Element wieder zum Diagramm hinzugefügt wird, muss die Texturdatei neu gesetzt werden.

Siehe auch Custom3DItem::textureFile.


void removeCustomItem(Custom3DItem item)

Entfernt das benutzerdefinierte item. Löscht die ihm zugewiesenen Ressourcen.


void removeCustomItemAt(vector3d position)

Entfernt alle benutzerdefinierten Elemente unter position. Löscht die ihnen zugewiesenen Ressourcen.


void removeCustomItems()

Entfernt alle benutzerdefinierten Elemente. Löscht die ihnen zugewiesenen Ressourcen.


void removeSeries(Bar3DSeries series)

Entfernt die series aus dem Diagramm.

Siehe auch GraphsItem3D::hasSeries().


Abstract3DAxis selectedAxis()

Kann verwendet werden, um die ausgewählte Achse nach dem Empfang des Signals selectedElementChanged mit einem beliebigen Etikettentyp zu erhalten. Die Auswahl ist bis zum nächsten selectedElementChanged Signal gültig.

Gibt die ausgewählte Achse oder Null zurück.

Siehe auch selectedElement.


Custom3DItem selectedCustomItem()

Kann verwendet werden, um das ausgewählte benutzerdefinierte Element nach dem Empfang des Signals selectedElementChanged mit dem Typ ElementType.CustomItem zu erhalten. Der Besitz des Elements bleibt beim Diagramm. Die Auswahl ist bis zum nächsten selectedElementChanged Signal gültig.

Gibt das ausgewählte benutzerdefinierte Element oder null zurück.

Siehe auch selectedElement.


qsizetype selectedCustomItemIndex()

Kann verwendet werden, um den Index des ausgewählten benutzerdefinierten Elements abzufragen, nachdem das Signal selectedElementChanged mit dem Typ ElementType.CustomItem empfangen wurde. Die Auswahl ist bis zum nächsten selectedElementChanged -Signal gültig.

Gibt den Index des ausgewählten benutzerdefinierten Eintrags oder -1 zurück.

Siehe auch selectedElement.


int selectedLabelIndex()

Kann verwendet werden, um den Index des ausgewählten Etiketts nach dem Empfang des Signals selectedElementChanged mit einem beliebigen Etikettentyp abzufragen. Die Auswahl ist bis zum nächsten selectedElementChanged -Signal gültig.

Gibt den Index des ausgewählten Etiketts oder -1 zurück.

Siehe auch selectedElement.


© 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.