QAbstractSeries Class

Dokumentation der Eigenschaften

name : QString

Diese Eigenschaft enthält den Namen der Serie.

Der Name wird in der Legende für die Serie angezeigt und unterstützt HTML-Formatierung.

Zugriffsfunktionen:

Benachrichtigungssignal:

opacity : qreal

Diese Eigenschaft enthält die Deckkraft der Serie.

Standardmäßig ist die Deckkraft 1,0. Die gültigen Werte reichen von 0,0 (transparent) bis 1,0 (undurchsichtig).

Zugriffsfunktionen:

Melder-Signal:

[read-only] type : const SeriesType

Diese Eigenschaft enthält den Typ der Reihe.

Zugriffsfunktionen:

useOpenGL : bool

Gibt an, ob das Zeichnen der Serie durch die Verwendung von OpenGL beschleunigt wird oder nicht.

Die Beschleunigung mit OpenGL wird nur für QLineSeries und QScatterSeries unterstützt. Eine Linienreihe, die als Randreihe für QAreaSeries verwendet wird, kann die OpenGL-Beschleunigung nicht nutzen. Wenn ein Diagramm Serien enthält, die mit OpenGL gezeichnet werden, wird ein transparentes QOpenGLWidget über dem Diagrammbereich erstellt. Die beschleunigten Serien werden nicht auf der zugrunde liegenden QGraphicsView gezeichnet, sondern auf dem erstellten QOpenGLWidget.

Der Leistungsgewinn durch die Verwendung von OpenGL zur Beschleunigung des Zeichnens von Reihen hängt von der zugrunde liegenden Hardware ab, ist aber in den meisten Fällen beträchtlich. Auf einem Standard-Desktop-Computer beispielsweise ermöglicht die Aktivierung der OpenGL-Beschleunigung für eine Serie normalerweise das Rendern von mindestens hundertmal mehr Punkten, ohne dass die Bildwiederholrate sinkt. Auch die Größe des Diagramms hat weniger Einfluss auf die Bildrate.

Die OpenGL-Beschleunigung des Zeichnens von Serien ist für Anwendungsfälle gedacht, die ein schnelles Zeichnen einer großen Anzahl von Punkten erfordern. Sie ist auf Effizienz optimiert, und daher fehlt den Serien, die sie verwenden, die Unterstützung für viele Funktionen, die für nicht beschleunigte Serien verfügbar sind:

• Serienanimationen werden für beschleunigte Serien nicht unterstützt.
• Punktbeschriftungen werden für beschleunigte Reihen nicht unterstützt.
• Stiftstile, Markierungsformen und Leuchtmarkierungen werden für beschleunigte Reihen ignoriert. Es werden nur durchgezogene Linien und einfache Streupunkte unterstützt. Die Streupunkte können kreisförmig oder rechteckig sein, abhängig von der zugrunde liegenden Grafikhardware und den Treibern.
• Polardiagramme unterstützen keine beschleunigten Reihen.
• Die Aktivierung von Schlagschatten oder die Verwendung einer transparenten Diagrammhintergrundfarbe wird bei der Verwendung von beschleunigten Reihen nicht empfohlen, da dies die Bildrate erheblich verlangsamen kann.

Diese zusätzlichen Einschränkungen ergeben sich aus der Tatsache, dass die beschleunigte Reihe in einem separaten Widget über dem Diagramm gezeichnet wird:

• Wenn Sie irgendwelche Grafikelemente über einem Diagramm zeichnen, das eine beschleunigte Serie enthält, wird die beschleunigte Serie über diesen Elementen gezeichnet.
• Damit QOpenGLWidget teilweise transparent sein kann, muss es über alle anderen Widgets gestapelt werden. Das bedeutet, dass Sie keine anderen Widgets haben können, die das Diagramm teilweise verdecken, wenn Sie beschleunigte Serien verwenden.
• Beschleunigte Reihen werden nicht für Anwendungsfälle unterstützt, in denen die Grafikszene mehr als eine zugeordnete Grafikansicht hat.
• Beschleunigte Serien werden nicht für Anwendungsfälle unterstützt, bei denen das Diagramm eine andere als die Standardgeometrie aufweist. Das Hinzufügen von Transformationen zur Grafikansicht führt beispielsweise dazu, dass die beschleunigte Reihe an einer falschen Position in Bezug auf das Diagramm gezeichnet wird.

Der Standardwert ist false.

Zugriffsfunktionen:

Benachrichtigungssignal:

visible : bool

Diese Eigenschaft gibt an, ob die Serie sichtbar ist oder nicht.

Standardmäßig ist true.

Zugriffsfunktionen:

Benachrichtigungssignal: