Auf dieser Seite

ItemModelScatterDataProxy QML Type

Proxy-Klasse zur Darstellung von Daten in Elementmodellen mit „ Scatter3D “. Mehr...

Import Statement: import QtGraphs
In C++: QItemModelScatterDataProxy
Inherits:

ScatterDataProxy

Eigenschaften

Signale

Ausführliche Beschreibung

Dieser Typ ermöglicht es Ihnen, von `AbstractItemModel` abgeleitete Modelle als Datenquelle für ` Scatter3D` zu verwenden.

Die Daten werden asynchron aufgelöst, sobald sich die Zuordnung oder das Modell ändert. „ QScatterDataProxy::arrayReset()“ wird ausgelöst, sobald die Daten aufgelöst wurden.

Weitere Informationen finden Sie in der Dokumentation zu ` QItemModelScatterDataProxy `.

Anwendungsbeispiel:

ItemModelScatterDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing point coordinates.
    // Mapping model roles to scatter series item coordinates.
    xPosRole: "xPos"
    yPosRole: "yPos"
    zPosRole: "zPos"
}

Siehe auch „ ScatterDataProxy “ und „Qt Graphs -Datenverarbeitung mit 3D“.

Dokumentation zu den Eigenschaften

itemModel : model

Das Artikelmodell, das als Datenquelle für „ Scatter3D “ verwendet werden soll.

rotationRole : string

Die Rolle des Artikelmodells, die der Artikelrotation zugeordnet werden soll. Das Modell kann den Wert für die Rotation entweder als Variante bereitstellen, die direkt in ` quaternion` konvertierbar ist, oder als eine der folgenden Zeichenfolgendarstellungen: ` "scalar,x,y,z" ` oder ` "@angle,x,y,z"`. Beim ersten Format wird ` quaternion ` direkt mit den angegebenen Werten erstellt, beim zweiten Format wird ` quaternion ` mithilfe der Methode ` QQuaternion::fromAxisAndAngle()` erstellt.

rotationRolePattern : regExp

Wenn diese Option aktiviert ist, wird der durch die Rotationsrolle zugeordnete Wert durchsucht und ersetzt, bevor er als Elementrotation verwendet wird. Diese Eigenschaft legt den regulären Ausdruck fest, mit dem der zu ersetzende Teil des zugeordneten Werts gesucht wird, und die Eigenschaft „ rotationRoleReplace “ enthält die Ersatzzeichenfolge.

Siehe auch „ rotationRole “ und „ rotationRoleReplace “.

rotationRoleReplace : string

Diese Eigenschaft definiert den Ersatzinhalt, der in Verbindung mit „ rotationRolePattern “ verwendet werden soll. Der Standardwert ist eine leere Zeichenkette. Weitere Informationen zur Funktionsweise der Suche und des Ersetzens mit regulären Ausdrücken finden Sie in der Dokumentation zur Funktion „ QString::replace “ (const QRegularExpression &rx, const QString &after).

Siehe auch „ rotationRole “ und „ rotationRolePattern “.

scaleRole : string

Das Modell kann den Wert für die Skalierung entweder als Variante „ "x,y,z" “ bereitstellen. Im ersten Fall wird der Vector3d direkt mit den angegebenen Werten erstellt.

scaleRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Skalenrolle zugeordnete Wert vor seiner Verwendung als Elementskala durchsucht und ersetzt. Diese Eigenschaft legt den regulären Ausdruck fest, mit dem der zu ersetzende Teil des zugeordneten Werts gefunden wird, und die Eigenschaft „ scaleRoleReplace “ enthält die Ersatzzeichenfolge.

Siehe auch „ scaleRole “ und „ scaleRoleReplace “.

scaleRoleReplace : string

Diese Eigenschaft definiert den Ersatzinhalt, der in Verbindung mit „ scaleRolePattern “ verwendet werden soll. Der Standardwert ist eine leere Zeichenkette. Weitere Informationen zur Funktionsweise des Such- und Ersetzvorgangs mit regulären Ausdrücken finden Sie in der Dokumentation zur Funktion „ QString::replace “ (const QRegularExpression &rx, const QString &after).

Siehe auch „ scaleRole “ und „ scaleRolePattern “.

type : AbstractDataProxy.DataType [read-only]

Der Typ des Proxys. Einer der Werte aus „ QAbstractDataProxy::DataType “.

xPosRole : string

Die Rolle des Elementmodells, die der X-Position zugeordnet werden soll.

xPosRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Rolle „x-position“ zugeordnete Wert durchsucht und ersetzt, bevor er als Positionswert für ein Element verwendet wird. Diese Eigenschaft gibt den regulären Ausdruck an, mit dem der zu ersetzende Teil des zugeordneten Werts gesucht wird, und die Eigenschaft „ xPosRoleReplace “ enthält die Ersatzzeichenfolge.

Siehe auch „ xPosRole “ und „ xPosRoleReplace “.

xPosRoleReplace : string

Diese Eigenschaft definiert den Ersatzinhalt, der in Verbindung mit „ xPosRolePattern “ verwendet werden soll. Der Standardwert ist eine leere Zeichenkette. Weitere Informationen zur Funktionsweise der Suche und des Ersetzens mit regulären Ausdrücken finden Sie in der Dokumentation zur Funktion „ QString::replace “ (const QRegularExpression &rx, const QString &after).

Siehe auch „ xPosRole “ und „ xPosRolePattern “.

yPosRole : string

Die Rolle des Elementmodells, die der Y-Position zugeordnet werden soll.

yPosRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Rolle „y-position“ zugeordnete Wert durchsucht und ersetzt, bevor er als Positionswert für ein Element verwendet wird. Diese Eigenschaft legt den regulären Ausdruck fest, mit dem der zu ersetzende Teil des zugeordneten Werts gesucht wird, und die Eigenschaft „ yPosRoleReplace “ enthält die Ersatzzeichenfolge.

Siehe auch „ yPosRole “ und „ yPosRoleReplace “.

yPosRoleReplace : string

Diese Eigenschaft definiert den Ersatzinhalt, der in Verbindung mit „ yPosRolePattern “ verwendet werden soll. Der Standardwert ist eine leere Zeichenkette. Weitere Informationen zur Funktionsweise des Suchens und Ersetzens mit regulären Ausdrücken finden Sie in der Dokumentation zur Funktion „ QString::replace “ (const QRegularExpression &rx, const QString &after).

Siehe auch „ yPosRole “ und „ yPosRolePattern “.

zPosRole : string

Die Rolle des Elementmodells, die auf die Z-Position abgebildet werden soll.

zPosRolePattern : regExp

Wenn diese Eigenschaft gesetzt ist, wird der durch die Rolle „z-position“ zugeordnete Wert einer Such- und Ersetzungsaktion unterzogen, bevor er als Positionswert für ein Element verwendet wird. Diese Eigenschaft legt den regulären Ausdruck fest, mit dem der zu ersetzende Teil des zugeordneten Werts gesucht wird, und die Eigenschaft „ zPosRoleReplace “ enthält die Ersetzungszeichenfolge.

Siehe auch „ zPosRole “ und „ zPosRoleReplace “.

zPosRoleReplace : string

Diese Eigenschaft definiert den Ersatzinhalt, der in Verbindung mit „ zPosRolePattern “ verwendet werden soll. Der Standardwert ist eine leere Zeichenkette. Weitere Informationen zur Funktionsweise der Suche und des Ersetzens mit regulären Ausdrücken finden Sie in der Dokumentation zur Funktion „ QString::replace “ (const QRegularExpression &rx, const QString &after).

Siehe auch „ zPosRole “ und „ zPosRolePattern “.

Signal-Dokumentation

itemModelChanged(model itemModel)

Dieses Signal wird ausgelöst, wenn sich „ itemModel “ in „ itemModel “ ändert.

Hinweis: Der entsprechende Handler lautet „ onItemModelChanged “.

rotationRoleChanged(string role)

Dieses Signal wird ausgelöst, wenn sich „ rotationRole “ in „ role “ ändert.

Hinweis: Der entsprechende Handler lautet „ onRotationRoleChanged “.

rotationRolePatternChanged(regExp pattern)

Dieses Signal wird ausgelöst, wenn sich „ rotationRolePattern “ in „ pattern “ ändert.

Hinweis: Der entsprechende Handler lautet onRotationRolePatternChanged.

rotationRoleReplaceChanged(string replace)

Dieses Signal wird ausgelöst, wenn sich rotationRoleReplace in replace ändert.

Hinweis: Der zugehörige Handler lautet onRotationRoleReplaceChanged.

scaleRoleChanged(string role)

Dieses Signal wird ausgelöst, wenn sich scaleRole in role ändert.

Hinweis: Der entsprechende Handler lautet onScaleRoleChanged.

scaleRolePatternChanged(regExp pattern)

Dieses Signal wird ausgelöst, wenn sich scaleRolePattern in pattern ändert.

Hinweis: Der entsprechende Handler lautet onScaleRolePatternChanged.

scaleRoleReplaceChanged(string replace)

Dieses Signal wird ausgelöst, wenn sich „ scaleRoleReplace “ in „ replace “ ändert.

Hinweis: Der entsprechende Handler lautet onScaleRoleReplaceChanged.

xPosRoleChanged(string role)

Dieses Signal wird ausgelöst, wenn sich „ xPosRole “ in „ role “ ändert.

Hinweis: Der entsprechende Handler lautet onXPosRoleChanged.

xPosRolePatternChanged(regExp pattern)

Dieses Signal wird ausgelöst, wenn sich „ xPosRolePattern “ in „ pattern “ ändert.

Hinweis: Der entsprechende Handler lautet onXPosRolePatternChanged.

xPosRoleReplaceChanged(string replace)

Dieses Signal wird ausgelöst, wenn sich xPosRoleReplace in replace ändert.

Hinweis: Der zugehörige Handler lautet onXPosRoleReplaceChanged.

yPosRoleChanged(string role)

Dieses Signal wird ausgelöst, wenn sich „ yPosRole “ in „ role “ ändert.

Hinweis: Der zugehörige Handler lautet onYPosRoleChanged.

yPosRolePatternChanged(regExp pattern)

Dieses Signal wird ausgelöst, wenn sich „ yPosRolePattern “ in „ pattern “ ändert.

Hinweis: Der entsprechende Handler lautet onYPosRolePatternChanged.

yPosRoleReplaceChanged(string replace)

Dieses Signal wird ausgelöst, wenn sich „ yPosRoleReplace “ in „ replace “ ändert.

Hinweis: Der entsprechende Handler lautet onYPosRoleReplaceChanged.

zPosRoleChanged(string role)

Dieses Signal wird ausgelöst, wenn sich „ zPosRole “ in „ role “ ändert.

Hinweis: Der entsprechende Handler lautet onZPosRoleChanged.

zPosRolePatternChanged(regExp pattern)

Dieses Signal wird ausgelöst, wenn sich zPosRolePattern in pattern ändert.

Hinweis: Der entsprechende Handler ist onZPosRolePatternChanged.

zPosRoleReplaceChanged(string replace)

Dieses Signal wird ausgelöst, wenn sich zPosRoleReplace in replace ändert.

Hinweis: Der entsprechende Handler lautet onZPosRoleReplaceChanged.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.