QAbstract3DGraph Class

Q3DBars *graphWindow = new Q3DBars;
graphWindow->setFlags(graphWindow->flags() ^ Qt::FramelessWindowHint);

Eigenschaftsdokumentation

activeInputHandler : QAbstract3DInputHandler*

Diese Eigenschaft enthält den aktiven Eingabe-Handler, der im Diagramm verwendet wird.

Zugriffsfunktionen:

Notifier-Signal:

activeTheme : Q3DTheme*

Diese Eigenschaft enthält das aktive Thema des Diagramms.

Zugriffsfunktionen:

Benachrichtigungssignal:

[since QtDataVisualization 1.1] 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 “.

Diese Aufzählung wurde in QtDataVisualization 1.1 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch horizontalAspectRatio.

[read-only, since QtDataVisualization 1.1] currentFps : qreal

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.

Diese Enumeration wurde in QtDataVisualization 1.1 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ measureFps “.

[since QtDataVisualization 1.2] horizontalAspectRatio : qreal

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

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

Hat keine Auswirkung auf „Q3DBars“, da die Skalierung auf der horizontalen Ebene dort über die Eigenschaften „ barThickness “ und „ barSpacing “ gesteuert wird. Auch Polardiagramme ignorieren diese Eigenschaft.

Diese Aufzählung wurde in QtDataVisualization 1.2 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

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

[since QtDataVisualization 1.2] locale : QLocale

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

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

Diese Aufzählung wurde in QtDataVisualization 1.2 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ QValue3DAxis::labelFormat “.

[since QtDataVisualization 1.2] 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 “.

Diese Aufzählung wurde in QtDataVisualization 1.2 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

[since QtDataVisualization 1.1] measureFps : bool

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

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

Diese Aufzählung wurde in QtDataVisualization 1.1 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ currentFps “.

optimizationHints : OptimizationHints

Diese Eigenschaft gilt unabhängig davon, ob zur Optimierung der Darstellung der Standardmodus oder der statische Modus verwendet wird.

Der Standardmodus bietet den vollen Funktionsumfang bei angemessener Leistung. Der statische Modus optimiert die Darstellung von Diagrammen und eignet sich ideal für große, unveränderliche Datensätze. Bei dynamischen Datenänderungen und der Rotation von Elementen 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 Standardwert ist „ OptimizationDefault “.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch QAbstract3DSeries::mesh.

[since QtDataVisualization 1.1] orthoProjection : bool

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

Standardwert ist „ false “.

Diese Aufzählung wurde in QtDataVisualization 1.1 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ QAbstract3DAxis::labelAutoRotation “ und „ Q3DCamera::cameraPreset “.

[since QtDataVisualization 1.2] polar : bool

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

Wenn „ true “ gilt, 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.

Diese Aufzählung wurde in QtDataVisualization 1.2 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ orthoProjection “ und „ radialLabelOffset “.

[read-only, since QtDataVisualization 1.2] queriedGraphPosition : QVector3D

Diese Eigenschaft enthält die zuletzt abgefragten Werte der Graphpositionen entlang jeder Achse.

Diese schreibgeschützte Eigenschaft enthält die Ergebnisse von „ Q3DScene::graphPositionQuery “. Die Werte werden 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.

Diese Aufzählung wurde in QtDataVisualization 1.2 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch Q3DScene::graphPositionQuery.

[since QtDataVisualization 1.2] radialLabelOffset : float

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

Diese Aufzählung wurde in QtDataVisualization 1.2 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ polar “.

[since QtDataVisualization 1.2] reflection : bool

Diese Eigenschaft legt fest, ob Bodenreflexionen aktiviert oder deaktiviert sind.

Standardwert ist „ false “.

Betrifft nur Q3DBars. In Q3DBars-Diagrammen, die sowohl positive als auch negative Werte enthalten, werden Reflexionen für benutzerdefinierte Elemente, die die Bodenebene schneiden, jedoch nicht unterstützt. In diesem Fall sollten Reflexionen deaktiviert werden, um eine fehlerhafte Darstellung zu vermeiden.

Bei Verwendung eines benutzerdefinierten Oberflächenformats muss der Stencil-Puffer definiert werden (QSurfaceFormat::setStencilBufferSize()), damit Reflexionen funktionieren.

Diese Aufzählung wurde in QtDataVisualization 1.2 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch reflectivity.

[since QtDataVisualization 1.2] reflectivity : qreal

Reflexionsgrad des Bodens.

Je höher der Wert, desto stärker reflektiert der Boden. Der gültige Bereich liegt zwischen [0...1]. Der Standardwert ist 0.5.

Diese Aufzählung wurde in QtDataVisualization 1.2 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch reflection.

[read-only] scene : Q3DScene*

Diese Eigenschaft enthält den Q3DScene-Zeiger, mit dem die Szene bearbeitet und auf Szenenelemente wie beispielsweise die aktive Kamera zugegriffen werden kann.

Diese Eigenschaft ist schreibgeschützt.

Zugriffsfunktionen:

[read-only, since QtDataVisualization 1.1] selectedElement : 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 wird und das Signal „ selectedElementChanged “ ausgelöst wird.

Das Signal kann beispielsweise zur Implementierung benutzerdefinierter Eingabe-Handler verwendet werden, wie im Beispiel in der „Graph Gallery“ auf der Registerkarte „ Scatter Graph “ gezeigt.

Diese Aufzählung wurde in QtDataVisualization 1.1 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ selectedLabelIndex()“, „ selectedAxis()“, „ selectedCustomItemIndex()“, „ selectedCustomItem()“, „ Q3DBars::selectedSeries()“, „ Q3DScatter::selectedSeries()“, „ Q3DSurface::selectedSeries()“ und „ Q3DScene::setSelectionQueryPosition()“.

selectionMode : SelectionFlags

Auswahlmodus für Elemente.

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

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch SelectionFlags.

shadowQuality : ShadowQuality

Diese Eigenschaft legt die Qualität des Schattens fest.

Einer der Werte der Aufzählung „ ShadowQuality “. Standardmäßig ist „ ShadowQualityMedium “ eingestellt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch „ ShadowQuality “.

#include <QtDataVisualization/qutils.h>

// ...

Q3DBars *graph = new Q3DBars(qDefaultSurfaceFormat(false));

#include <QtDataVisualization/qutils.h>

// ...

QQuickView viewer;
viewer.setFormat(qDefaultSurfaceFormat(true));