QAbstract3DGraph Class

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

Dokumentation der Eigenschaften

activeInputHandler : QAbstract3DInputHandler*

Diese Eigenschaft enthält den im Diagramm verwendeten aktiven Input-Handler.

Zugriffsfunktionen:

Melder-Signal:

activeTheme : Q3DTheme*

Diese Eigenschaft enthält das aktive Thema des Diagramms.

Zugriffsfunktionen:

Benachrichtigungssignal:

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

Diese Eigenschaft wurde in QtDataVisualization 1.1 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch horizontalAspectRatio.

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

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 der Aktivierung der Messung aktualisiert wird.

Diese Eigenschaft wurde in QtDataVisualization 1.1 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch measureFps.

[since QtDataVisualization 1.2] 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 Q3DBars, das die Skalierung auf der horizontalen Ebene über die Eigenschaften barThickness und barSpacing handhabt. Polardiagramme ignorieren diese Eigenschaft ebenfalls.

Diese Eigenschaft 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 das Gebietsschema, das für die Formatierung verschiedener numerischer Bezeichnungen verwendet wird.

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

Diese Eigenschaft 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 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 Bereichs der y-Achse interpretiert, wenn die Seitenverhältnisse des Diagramms nicht von den Standardwerten abgewichen sind. Der Standardwert ist -1.0.

Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

[since QtDataVisualization 1.1] 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. Der Standardwert ist false.

Diese Eigenschaft wurde in QtDataVisualization 1.1 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch currentFps.

optimizationHints : OptimizationHints

Diese Eigenschaft gibt an, ob der Standard- oder der statische Modus für die Rendering-Optimierung verwendet wird.

Der Standardmodus bietet den vollen Funktionsumfang bei einem angemessenen Leistungsniveau. Der statische Modus optimiert das Rendering des Diagramms und ist ideal für große, unveränderliche 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 Streudiagrammen. Die Standardeinstellung ist OptimizationDefault.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch QAbstract3DSeries::mesh.

[since QtDataVisualization 1.1] orthoProjection : bool

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

Die Standardeinstellung ist false.

Diese Eigenschaft 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 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 Voreinstellung ist false.

Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch orthoProjection und radialLabelOffset.

[read-only, since QtDataVisualization 1.2] 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.

Diese Eigenschaft 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 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 ist.

Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.

Zugriffsfunktionen:

Notifier Signal:

Siehe auch polar.

[since QtDataVisualization 1.2] reflection : bool

Diese Eigenschaft gibt an, ob Bodenreflexionen ein- oder ausgeschaltet sind.

Die Standardeinstellung ist false.

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

Wenn ein benutzerdefiniertes Oberflächenformat verwendet wird, muss der Schablonenpuffer definiert werden (QSurfaceFormat::setStencilBufferSize()), damit die Spiegelungen funktionieren.

Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch reflectivity.

[since QtDataVisualization 1.2] reflectivity : qreal

Reflexionsgrad des Bodens.

Größere Zahlen bedeuten, dass der Boden stärker reflektiert. Der gültige Bereich ist [0...1]. Die Standardeinstellung ist 0.5.

Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch reflection.

[read-only] scene : Q3DScene* const

Diese Eigenschaft enthält den Zeiger Q3DScene, der verwendet werden kann, um die Szene zu manipulieren und auf die Szenenelemente zuzugreifen, wie z. B. die aktive Kamera.

Diese Eigenschaft ist schreibgeschützt.

Zugriffsfunktionen:

[read-only, since QtDataVisualization 1.1] selectedElement : const 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 Eingabehandlern verwendet werden, wie im Beispiel der Graph Gallery unter dem Reiter Scatter Graph gezeigt.

Diese Eigenschaft 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

Modus der Artikelauswahl.

Eine Kombination aus SelectionFlags. Standardmäßig ist SelectionItem eingestellt. Verschiedene Diagrammtypen unterstützen unterschiedliche Auswahlmodi.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch SelectionFlags.

shadowQuality : ShadowQuality

Diese Eigenschaft gibt die Qualität des Schattens an.

Einer der ShadowQuality enum-Werte. Standardmäßig ist dies ShadowQualityMedium.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch ShadowQuality.

#include <QtDataVisualization/qutils.h>

// ...

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

#include <QtDataVisualization/qutils.h>

// ...

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