Q3DGraphsWidgetItem Class

Dokumentation zu den Eigenschaften

activeTheme : QGraphsTheme*

Diese Eigenschaft enthält das aktive Thema des Diagramms.

Legt „ activeTheme “ als aktives Design fest, das für das Diagramm verwendet werden soll. Ruft implizit „ addTheme()“ auf, um die Eigentumsrechte am Design auf dieses Diagramm zu übertragen.

Ist activeTheme null, wird ein temporäres Standard-Thema erstellt. Dieses temporäre Thema wird gelöscht, sobald später ein Thema explizit festgelegt wird. Die Eigenschaften des Themas können auch nach dessen Festlegung geändert werden; die Änderungen werden sofort wirksam.

Zugriffsfunktionen:

Notifier-Signal:

ambientLightStrength : float

Diese Eigenschaft legt die Umgebungshelligkeit für das gesamte Diagramm fest.

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

Der Wert muss zwischen 0.0f und 1.0f liegen.

Zugriffsfunktionen:

Benachrichtigungssignal:

aspectRatio : qreal

Diese Eigenschaft gibt das Skalierungsverhältnis des Diagramms zwischen der längsten Achse auf der horizontalen Ebene und der y-Achse an.

Standardwert ist „ 2.0 “.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ horizontalAspectRatio “.

cameraPreset : QtGraphs3D::CameraPreset

Die voreingestellte Kameraposition, die die Kamera derzeit verwendet. Der Wert kann auf einen der Werte der Enumeration „CameraPreset“ gesetzt werden. Mit dieser Eigenschaft lässt sich ein vordefinierter Kamerawinkel festlegen, aus dem das Diagramm betrachtet wird.

Standardmäßig ist die Kamera-Voreinstellung auf „ CameraPreset::FrontLow “ gesetzt.

Zugriffsfunktionen:

Notifier-Signal:

cameraTargetPosition : QVector3D

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

Der Standardwert ist QVector3D(0.0, 0.0, 0.0).

Gültige Koordinatenwerte liegen im Bereich von -1.0...1.0, wobei die Grenzwerte die Ränder des entsprechenden Achsenbereichs angeben. Alle Werte außerhalb dieses Bereichs werden auf den Rand begrenzt.

Zugriffsfunktionen:

Benachrichtigungssignal:

cameraXRotation : float

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

Zugriffsfunktionen:

Benachrichtigungssignal:

cameraYRotation : float

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

Zugriffsfunktionen:

Benachrichtigungssignal:

cameraZoomLevel : float

Diese Eigenschaft gibt den Zoomfaktor der Kamera in Prozent an.

Der Standardwert „ 100.0f “ bedeutet, dass in der Kamera kein Vergrößerungs- oder Verkleinerungsfaktor eingestellt ist. Der Wert wird durch die Eigenschaften „ minCameraZoomLevel “ und „ maxCameraZoomLevel “ begrenzt.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ minCameraZoomLevel “ und „ maxCameraZoomLevel “.

[read-only] currentFps : int

Diese Eigenschaft enthält die Darstellungsergebnisse der letzten Sekunde.

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

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ measureFps “.

[since 6.11] cutoffMargin : qreal

Diese Eigenschaft enthält den Wert, der für den Abstand zwischen den Achsengrenzen und der Position verwendet wird, an der Diagrammelemente ausgeblendet werden.

Diese Aufzählung wurde in Qt 6.11 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

[since 6.12] dragMode : QtGraphs3D::DragMode

Legt fest, wie Drag-Ereignisse im Diagramm interpretiert werden; einer der Aufzählungswerte „ QtGraphs3D::DragMode “.

Standardwert ist „ QtGraphs3D::DragMode::Rotate “.

Diese Aufzählung wurde in Qt 6.12 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ panEnabled “.

gridLineType : QtGraphs3D::GridLineType

Diese Eigenschaft gilt unabhängig davon, ob der Typ der Gitterlinien „ QtGraphs3D::GridLineType::Shader “ oder „ QtGraphs3D::GridLineType::Geometry “ ist.

Dieser Wert wirkt sich auf alle Gitterlinien aus.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ QtGraphs3D::GridLineType “.

horizontalAspectRatio : qreal

Diese Eigenschaft legt das Skalierungsverhältnis zwischen der x-Achse und der z-Achse im Diagramm fest.

Der Wert „ 0.0 “ gibt an, dass die Skalierung automatisch entsprechend den Achsenbereichen erfolgt. Der Standardwert ist „ 0.0 “.

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

Zugriffsfunktionen:

Benachrichtigungssignal:

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

labelMargin : float

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

Bei negativen Werten werden die Beschriftungen innerhalb des Darstellungsbereichs platziert, bei positiven Werten außerhalb des Darstellungsbereichs. Die automatische Drehung der Beschriftungen ist deaktiviert, wenn der Wert negativ ist. Standardwert ist 0.1

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch QAbstract3DAxis::labelAutoAngle.

lightColor : QColor

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

Dieser Wert wirkt sich auf das unter „ Q3DScene “ angegebene Licht aus.

Zugriffsfunktionen:

Benachrichtigungssignal:

lightStrength : float

Diese Eigenschaft enthält die Stärke des Spiegelungslichts für den gesamten Graphen.

Der Wert muss zwischen 0.0f und 10.0f liegen.

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

Zugriffsfunktionen:

Benachrichtigungssignal:

locale : QLocale

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

Standardmäßig ist die Locale „ "C" “ eingestellt.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ QValue3DAxis::labelFormat “.

margin : qreal

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

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

Zugriffsfunktionen:

Benachrichtigungssignal:

maxCameraXRotation : float

Diese Eigenschaft enthält den maximalen X-Drehwinkel der Kamera um den Zielpunkt in Grad. Der Standardwert ist 180.0

Zugriffsfunktionen:

Benachrichtigungssignal:

maxCameraYRotation : float

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

Zugriffsfunktionen:

Benachrichtigungssignal:

maxCameraZoomLevel : float

Diese Eigenschaft gibt den maximal zulässigen Zoomfaktor der Kamera an.

Wird der Maximalwert auf einen neuen Wert gesetzt, der unter dem bestehenden Minimalwert liegt, wird auch der Minimalwert an den neuen Maximalwert angepasst. Liegt der aktuelle Wert „ cameraZoomLevel “ außerhalb der neuen Grenzen, wird dieser ebenfalls angepasst. Der Standardwert ist „ 500.0f “.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ cameraZoomLevel “ und „ minCameraZoomLevel “.

measureFps : bool

Diese Eigenschaft legt fest, ob die Darstellung kontinuierlich statt bei Bedarf erfolgt.

Wenn „ true “ gilt, erfolgt die Darstellung kontinuierlich und der Wert der Eigenschaft „ currentFps “ wird aktualisiert. Der Standardwert ist „ false “.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ currentFps “.

minCameraXRotation : float

Diese Eigenschaft enthält den minimalen X-Drehwinkel der Kamera um den Zielpunkt in Grad. Der Standardwert lautet -180.0

Zugriffsfunktionen:

Benachrichtigungssignal:

minCameraYRotation : float

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

Zugriffsfunktionen:

Benachrichtigungssignal:

minCameraZoomLevel : float

Diese Eigenschaft gibt den minimal zulässigen Zoomfaktor der Kamera an.

Wird der Mindestwert auf einen neuen Wert gesetzt, der höher ist als der bestehende Höchstwert, wird auch der Höchstwert an den neuen Mindestwert angepasst. Liegt der aktuelle ZoomLevel außerhalb der neuen Grenzen, wird er ebenfalls angepasst. Der Wert „minCameraZoomLevel“ kann nicht unter „ 1.0f “ festgelegt werden. Der Standardwert ist „ 10.0f “.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch cameraZoomLevel und maxCameraZoomLevel.

msaaSamples : int

Diese Eigenschaft gibt die Anzahl der bei MSAA verwendeten Samples an.

Legt die Anzahl der verwendeten MSAA-Samples auf „ samples “ fest. Die Anzahl der Samples kann entweder 0, 2, 4 oder 8 betragen.

Zugriffsfunktionen:

Benachrichtigungssignal:

optimizationHint : QtGraphs3D::OptimizationHint

Legt fest, ob zur Optimierung der Darstellung der Standardmodus oder der Legacy-Modus verwendet wird.

Der Standardmodus nutzt instanziertes Rendering und bietet auf den meisten Systemen den vollen Funktionsumfang bei bester Leistung. Der statische Modus optimiert das Rendern von Diagrammen und eignet sich ideal für große, unveränderliche Datensätze. Bei dynamischen Datenänderungen und Elementrotationen ist er langsamer. Die Auswahl wird nicht optimiert, daher ist die Verwendung des statischen Modus bei sehr großen Datensätzen nicht empfehlenswert. Die statische Optimierung funktioniert nur bei Streudiagrammen. 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 Standardeinstellung ist „ QtGraphs3D::OptimizationHint::Default “.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch QAbstract3DSeries::mesh.

orthoProjection : bool

Diese Eigenschaft legt fest, ob für die Darstellung des Diagramms eine orthogonale Projektion verwendet wird.

Standardwert ist „ false “.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ QAbstract3DAxis::labelAutoAngle “.

[since 6.12] panEnabled : bool

Diese Eigenschaft gibt an, ob dieser Eingabe-Handler das Verschieben im Diagramm zulässt.

Standardwert ist „ true “.

Diese Aufzählung wurde in Qt 6.12 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ dragMode “ und „ setPanButton()“.

polar : bool

Diese Eigenschaft gilt unabhängig davon, ob horizontale Achsen in Polarkoordinatenachsen umgewandelt werden.

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

Standardmäßig ist „ false “ eingestellt.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ orthoProjection “ und „ radialLabelOffset “.

[read-only] queriedGraphPosition : QVector3D

Diese Eigenschaft enthält die zuletzt abgefragten Werte für die Graphpositionen entlang jeder Achse.

Diese schreibgeschützte Eigenschaft enthält die Ergebnisse von Q3DScene::graphPositionQuery. Die Werte sind auf den Bereich [-1, 1] normiert. Liegt die abgefragte Position außerhalb der Diagrammgrenzen, 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 undefiniert, bis eine Abfrage erfolgt.

Da es keine eindeutige 3D-Koordinate gibt, die einer bestimmten Bildschirmposition entspricht, erfolgen die Abfragen aus Gründen der Konsistenz stets an den Innenseiten eines unsichtbaren Rahmens, der das Diagramm umgibt.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch Q3DScene::graphPositionQuery.

radialLabelOffset : float

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

Der Wert „ 0.0 “ gibt an, dass die Beschriftungen neben der Winkelachsen-Gitterlinie bei 0° gezeichnet werden sollen. Der Wert „ 1.0 “ gibt an, dass die Beschriftungen an ihrer üblichen Stelle am Rand des Diagrammhintergrunds gezeichnet werden. Der Standardwert ist „ 1.0 “.

Diese Eigenschaft wird ignoriert, wenn der Wert der Eigenschaft „ polar “ auf „ false “ gesetzt ist.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ polar “.

rotationEnabled : bool

Diese Eigenschaft gibt an, ob dieser Eingabe-Handler die Drehung von Diagrammen zulässt.

Standardwert ist „ true “.

Zugriffsfunktionen:

Notifier-Signal:

[read-only] scene : Q3DScene* const

Diese Eigenschaft enthält den Zeiger „ Q3DScene “, mit dem die Szene bearbeitet und auf die Szenenelemente zugegriffen werden kann.

Diese Eigenschaft ist schreibgeschützt.

Zugriffsfunktionen:

[read-only] selectedElement : QtGraphs3D::ElementType

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

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

Das Signal kann beispielsweise zur Implementierung benutzerdefinierter Eingabehandler verwendet werden, wie im Beispiel der Graph-Galerie auf 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 Eingabe-Handler die Auswahl aus dem Diagramm zulässt.

Standardwert ist „ true “.

Zugriffsfunktionen:

Notifier-Signal:

selectionMode : QtGraphs3D::SelectionFlags

Auswahlmodus für Elemente.

Eine Kombination aus „SelectionFlags“. Standardmäßig gilt: „ Item “. Verschiedene Diagrammtypen unterstützen unterschiedliche Auswahlmodi.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ QtGraphs3D::SelectionFlags “.

shadowQuality : QtGraphs3D::ShadowQuality

Diese Eigenschaft legt die Qualität des Schattens fest.

Einer der Werte der Enumeration „ShadowQuality“. Standardmäßig ist „ Medium “ eingestellt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ QtGraphs3D::ShadowQuality “.

shadowStrength : float

Diese Eigenschaft legt die Schattenintensität für das gesamte Diagramm fest.

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 die unter Q3DScene festgelegte Beleuchtung aus.

Zugriffsfunktionen:

Benachrichtigungssignal:

[since 6.9] transparencyTechnique : QtGraphs3D::TransparencyTechnique

Legt fest, welche Transparenztechnik verwendet werden soll. Der Standardwert ist „ Default “. Verwenden Sie beim Rendern transparenter Oberflächendiagramme „ Approximate “ oder „ Accurate “. Für andere Diagrammtypen sollte „ Default “ verwendet werden.

Diese Aufzählung wurde in Qt 6.9 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ QtGraphs3D::TransparencyTechnique “.

wrapCameraXRotation : bool

Diese Eigenschaft legt das Verhalten der Minimal- und Maximalgrenzen bei der X-Drehung fest.

Bei der Einstellung „ true “ wird die X-Rotation der Kamera vom Minimalwert zum Maximalwert und vom Maximalwert zum Minimalwert umgeschaltet. Bei der Einstellung „ false “ ist die X-Rotation der Kamera auf den durch den Minimal- und Maximalwert bestimmten Sektor beschränkt. Standardmäßig ist „ true “ eingestellt.

Zugriffsfunktionen:

Benachrichtigungssignal:

wrapCameraYRotation : bool

Diese Eigenschaft legt das Verhalten der Minimal- und Maximalgrenzen bei der Y-Drehung fest.

Wenn „ true “ eingestellt ist, wird die Y-Rotation der Kamera vom Minimalwert zum Maximalwert und vom Maximalwert zum Minimalwert umgeschaltet. Wenn „ false “ eingestellt ist, ist die Y-Rotation der Kamera auf den durch den Minimal- und Maximalwert bestimmten Bereich beschränkt. Standardmäßig ist „ true “ eingestellt.

Zugriffsfunktionen:

Benachrichtigungssignal:

zoomAtTargetEnabled : bool

Diese Eigenschaft legt fest, ob beim Zoomen das Kameraziel so geändert werden soll, dass der gezoomte Punkt im Diagramm nach dem Zoomen an derselben Stelle bleibt.

Standardwert ist „ true “.

Zugriffsfunktionen:

Notifier-Signal:

zoomEnabled : bool

Diese Eigenschaft gibt an, ob dieser Eingabe-Handler das Zoomen im Diagramm zulässt.

Standardwert ist „ true “.

Zugriffsfunktionen:

Notifier-Signal:

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