Q3DGraphsWidgetItem Class

Dokumentation der Eigenschaften

activeTheme : QGraphsTheme*

Diese Eigenschaft enthält das aktive Thema des Diagramms.

Legt activeTheme als aktives Thema fest, das für den Graphen verwendet werden soll. Ruft implizit addTheme() auf, um den Besitz des Themas auf diesen Graphen zu übertragen.

Wenn activeTheme null ist, wird ein temporäres Standardthema erstellt. Dieses temporäre Thema wird zerstört, wenn später ein Thema explizit festgelegt wird. Die Eigenschaften des Themas können auch nach dem Setzen des Themas geändert werden, und die Änderungen werden sofort wirksam.

Zugriffsfunktionen:

Benachrichtigungssignal:

ambientLightStrength : float

Diese Eigenschaft enthält die Umgebungslichtstärke für das gesamte Diagramm.

Dieser Wert bestimmt, wie gleichmäßig und hell die Farben im gesamten Diagramm angezeigt werden, unabhängig von der Lichtposition.

Der Wert muss zwischen 0.0f und 1.0f liegen.

Zugriffsfunktionen:

Benachrichtigungssignal:

aspectRatio : qreal

Diese Eigenschaft enthält das Verhältnis der Diagrammskalierung zwischen der längsten Achse auf der horizontalen Ebene und der y-Achse.

Die Standardeinstellung ist 2.0.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch horizontalAspectRatio.

cameraTargetPosition : QVector3D

Diese Eigenschaft enthält die Kamerazielposition als Vektor oder Scheitelpunkt im 3D-Raum.

Der Standardwert ist QVector3D(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.

Zugriffsfunktionen:

Melder-Signal:

cameraXRotation : float

Diese Eigenschaft enthält den X-Drehwinkel der Kamera um den Zielpunkt in Grad.

Zugriffsfunktionen:

Melder-Signal:

cameraYRotation : float

Diese Eigenschaft enthält den Y-Drehwinkel der Kamera um den Zielpunkt in Grad.

Zugriffsfunktionen:

Melder-Signal:

cameraZoomLevel : float

Diese Eigenschaft gibt die Zoomstufe der Kamera in Prozent an.

Der Standardwert 100.0f bedeutet, dass in der Kamera kein Vergrößern oder Verkleinern eingestellt ist. Der Wert wird durch die Eigenschaften minCameraZoomLevel und maxCameraZoomLevel begrenzt.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch minCameraZoomLevel und maxCameraZoomLevel.

[read-only] currentFps : const int

Diese Eigenschaft enthält die Rendering-Ergebnisse für die letzte Sekunde.

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

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch measureFps.

gridLineType : QtGraphs3D::GridLineType

Diese Eigenschaft gibt an, ob der Typ der Gitterlinien QtGraphs3D::GridLineType::Shader oder QtGraphs3D::GridLineType::Geometry ist.

Dieser Wert wirkt sich auf alle Gitternetzlinien aus.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch QtGraphs3D::GridLineType.

horizontalAspectRatio : qreal

Diese Eigenschaft enthält 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.

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

Zugriffsfunktionen:

Benachrichtigungssignal:

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

labelMargin : float

Diese Eigenschaft gibt den Rand für die Platzierung der Achsenbeschriftungen an.

Negative Werte platzieren die Beschriftungen innerhalb des Plotbereichs, während positive Werte sie außerhalb des Plotbereichs platzieren. Die automatische Drehung der Beschriftungen ist deaktiviert, wenn der Wert negativ ist. Standardmäßig auf 0.1

Zugriffsfunktionen:

Melder-Signal:

Siehe auch QAbstract3DAxis::labelAutoAngle.

lightColor : QColor

Diese Eigenschaft enthält die Farbe für das Umgebungs- und Spiegellicht.

Dieser Wert beeinflusst das in Q3DScene angegebene Licht.

Zugriffsfunktionen:

Benachrichtigungssignal:

lightStrength : float

Diese Eigenschaft enthält die Stärke des Spiegellichts für das gesamte Diagramm.

Der Wert muss zwischen 0.0f und 10.0f liegen.

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

Zugriffsfunktionen:

Benachrichtigungssignal:

locale : QLocale

Diese Eigenschaft enthält das Gebietsschema, das für die Formatierung verschiedener numerischer Bezeichnungen verwendet wird.

Standardmäßig wird das Gebietsschema "C" verwendet.

Zugriffsfunktionen:

Melder-Signal:

Siehe auch QValue3DAxis::labelFormat.

margin : qreal

Diese Eigenschaft enthält den absoluten Wert, der für den Abstand zwischen dem Rand des plottbaren Diagrammbereichs und dem Rand des Diagrammhintergrunds verwendet wird.

Wenn der Randwert 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.

Zugriffsfunktionen:

Melder-Signal:

maxCameraXRotation : float

Diese Eigenschaft enthält den maximalen X-Rotationswinkel der Kamera um den Zielpunkt in Grad.

Zugriffsfunktionen:

Melder-Signal:

maxCameraYRotation : float

Diese Eigenschaft enthält den maximalen Y-Drehwinkel der Kamera um den Zielpunkt in Grad.

Zugriffsfunktionen:

Melder-Signal:

maxCameraZoomLevel : float

Diese Eigenschaft enthält die maximal zulässige Zoomstufe der Kamera.

Wenn die maximale Stufe auf einen neuen Wert gesetzt wird, der niedriger ist als die bestehende 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.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch cameraZoomLevel und minCameraZoomLevel.

measureFps : bool

Diese Eigenschaft gibt an, ob das Rendering kontinuierlich und nicht nur bei Bedarf erfolgt.

Wenn true, erfolgt das Rendering kontinuierlich und der Wert der Eigenschaft currentFps wird aktualisiert. Die Standardeinstellung ist false.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch currentFps.

minCameraXRotation : float

Diese Eigenschaft enthält den minimalen X-Rotationswinkel der Kamera um den Zielpunkt in Grad.

Zugriffsfunktionen:

Melder-Signal:

minCameraYRotation : float

Diese Eigenschaft enthält den minimalen Y-Drehwinkel der Kamera um den Zielpunkt in Grad.

Zugriffsfunktionen:

Melder-Signal:

minCameraZoomLevel : float

Diese Eigenschaft enthält die minimal zulässige Zoomstufe der Kamera.

Wenn die minimale Stufe auf einen neuen Wert gesetzt wird, der höher ist als die vorhandene maximale Stufe, wird die maximale Stufe ebenfalls an das neue Minimum angepasst. Liegt der aktuelle ZoomLevel außerhalb der neuen Grenzen, wird er ebenfalls angepasst. Der Wert von minCameraZoomLevel kann nicht unter 1.0f gesetzt werden. Der Standardwert ist 10.0f.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch cameraZoomLevel und maxCameraZoomLevel.

msaaSamples : int

Diese Eigenschaft enthält die Anzahl der verwendeten Samples in MSAA.

Setzt die Anzahl der verwendeten MSAA-Samples auf samples. Die Anzahl der Samples kann entweder 0, 2, 4 oder 8 sein.

Zugriffsfunktionen:

Anmelder-Signal:

optimizationHint : QtGraphs3D::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 ä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. Die statische Optimierung funktioniert nur bei Punktediagrammen. Der Legacy-Modus stellt alle Elemente im Diagramm einzeln dar, ohne Instanzierung. Er sollte nur verwendet werden, wenn der Standardmodus nicht funktioniert, d. h. wenn das Zielsystem keine Instanzierung unterstützt. Die Voreinstellung ist QtGraphs3D::OptimizationHint::Default.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch QAbstract3DSeries::mesh.

orthoProjection : bool

Diese Eigenschaft gibt an, ob die orthografische Projektion für die Darstellung des Diagramms verwendet wird.

Die Standardeinstellung ist false.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch QAbstract3DAxis::labelAutoAngle.

polar : bool

Diese Eigenschaft bestimmt, ob horizontale Achsen in polare Achsen umgewandelt werden.

Wenn true, wird die x-Achse zur Winkelachse und die z-Achse zur Radialachse. Der Polarmodus ist für Balkendiagramme nicht verfügbar.

Die Standardeinstellung ist false.

Zugriffsfunktionen:

Melder-Signal:

Siehe auch orthoProjection und radialLabelOffset.

[read-only] queriedGraphPosition : const QVector3D

Diese Eigenschaft enthält die zuletzt abgefragten Diagrammpositionswerte entlang jeder Achse.

Diese schreibgeschützte Eigenschaft enthält die Ergebnisse von Q3DScene::graphPositionQuery. Die Werte sind auf den Bereich [-1, 1] normiert. Wenn die abgefragte Position außerhalb der Diagrammgrenzen lag, spiegeln die Werte nicht die tatsächliche Position wider, sondern zeigen stattdessen eine undefinierte Position außerhalb des Bereichs [-1, 1] an. 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.

Zugriffsfunktionen:

Melder-Signal:

Siehe auch Q3DScene::graphPositionQuery.

radialLabelOffset : float

Diese Eigenschaft enthält den normierten horizontalen Versatz für die Achsenbeschriftungen der radialen Polarachse.

Der Wert 0.0 gibt an, dass die Beschriftungen neben der Gitternetzlinie der Winkelachse mit dem Winkel 0 gezeichnet werden sollen. Der Wert 1.0 zeigt an, dass die Beschriftungen an ihrem üblichen Platz am Rand des Diagrammhintergrunds gezeichnet werden. Der Standardwert ist 1.0.

Diese Eigenschaft wird ignoriert, wenn der Wert der Eigenschaft polar false lautet.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch polar.

rotationEnabled : bool

Diese Eigenschaft gibt an, ob dieser Input-Handler eine Drehung des Graphen zulässt.

Der Standardwert ist true.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] scene : Q3DScene* const

Diese Eigenschaft enthält den Zeiger Q3DScene, der zur Bearbeitung der Szene und zum Zugriff auf die Szenenelemente verwendet werden kann.

Diese Eigenschaft ist schreibgeschützt.

Zugriffsfunktionen:

[read-only] selectedElement : const QtGraphs3D::ElementType

Diese Eigenschaft enthält das im Diagramm ausgewählte Element.

Diese Eigenschaft kann zur Abfrage des ausgewählten Elementtyps verwendet werden. 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. für die Implementierung von benutzerdefinierten Input-Handlern verwendet werden, wie im Beispiel der Graph Gallery unter der Registerkarte Scatter Graph gezeigt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch selectedLabelIndex(), selectedAxis(), selectedCustomItemIndex(), selectedCustomItem(), Q3DBarsWidgetItem::selectedSeries(), Q3DScatterWidgetItem::selectedSeries(), Q3DSurfaceWidgetItem::selectedSeries(), und Q3DScene::setSelectionQueryPosition().

selectionEnabled : bool

Diese Eigenschaft gibt an, ob dieser Input-Handler eine Auswahl aus dem Diagramm erlaubt.

Der Standardwert ist true.

Zugriffsfunktionen:

Benachrichtigungssignal:

selectionMode : QtGraphs3D::SelectionFlags

Modus der Elementauswahl.

Eine Kombination von SelectionFlags. Standardmäßig: Item. Verschiedene Diagrammtypen unterstützen unterschiedliche Auswahlmodi.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch QtGraphs3D::SelectionFlags.

shadowQuality : QtGraphs3D::ShadowQuality

Diese Eigenschaft gibt die Qualität des Schattens an.

Einer der Werte aus der Aufzählung ShadowQuality. Standardmäßig ist dies Medium.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch QtGraphs3D::ShadowQuality.

shadowStrength : float

Diese Eigenschaft enthält die Schattenstärke für das gesamte Diagramm.

Je höher der Wert ist, desto dunkler sind die Schatten. Der Wert muss zwischen 0.0 und 100.0 liegen.

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

Zugriffsfunktionen:

Benachrichtigungssignal:

wrapCameraXRotation : bool

Diese Eigenschaft bestimmt das Verhalten der minimalen und maximalen Grenzen der X-Drehung.

Wenn sie auf true gesetzt ist, wird die X-Drehung der Kamera vom Minimum zum Maximum und vom Maximum zum Minimum umgeschlagen. Bei false ist die X-Drehung der Kamera auf den durch die Minimal- und Maximalwerte bestimmten Sektor begrenzt. Standardmäßig auf true eingestellt.

Zugriffsfunktionen:

Melder-Signal:

wrapCameraYRotation : bool

Diese Eigenschaft bestimmt das Verhalten der minimalen und maximalen Grenzen der Y-Drehung.

Wenn true, wird die Y-Drehung der Kamera vom Minimum zum Maximum und vom Maximum zum Minimum umgeschlagen. Wenn false, wird die Y-Drehung der Kamera auf den durch die Minimal- und Maximalwerte bestimmten Sektor begrenzt. Standardmäßig auf true eingestellt.

Zugriffsfunktionen:

Melder-Signal:

zoomAtTargetEnabled : bool

Diese Eigenschaft legt fest, ob beim Zoomen das Kameraziel geändert werden soll, damit der gezoomte Punkt des Diagramms nach dem Zoomen an der gleichen Stelle bleibt.

Die Standardeinstellung ist true.

Zugriffsfunktionen:

Benachrichtigungssignal:

zoomEnabled : bool

Diese Eigenschaft gibt an, ob dieser Input-Handler das Zoomen des Diagramms erlaubt.

Der Standardwert ist true.

Zugriffsfunktionen:

Benachrichtigungssignal:

QQuickWidget quickwidget;
Q3DBarsWidgetItem graph;
graph.setWidget(&quickwidget);