QGraphicsObject Class
Die Klasse `QGraphicsObject` dient als Basisklasse für alle Grafikelemente, die Signale, Slots und Eigenschaften benötigen. Mehr...
| Header: | #include <QGraphicsObject> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | QObject und QGraphicsItem |
| Vererbt an: |
Eigenschaften
Öffentliche Funktionen
| QGraphicsObject(QGraphicsItem *parent = nullptr) | |
| virtual | ~QGraphicsObject() |
| void | grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags()) |
| void | ungrabGesture(Qt::GestureType gesture) |
Signale
| void | enabledChanged() |
| void | opacityChanged() |
| void | parentChanged() |
| void | rotationChanged() |
| void | scaleChanged() |
| void | visibleChanged() |
| void | xChanged() |
| void | yChanged() |
| void | zChanged() |
Neu implementierte geschützte Funktionen
| virtual bool | event(QEvent *ev) override |
Geschützte Slots
| void | updateMicroFocus() |
Detaillierte Beschreibung
Die Klasse erweitert eine „ QGraphicsItem “ um die Signal-/Slot- und Eigenschaftsmechanismen von „ QObject “. Sie ordnet viele der grundlegenden Setter und Getter von „ QGraphicsItem “ den Eigenschaften zu und fügt für viele davon Benachrichtigungssignale hinzu.
Eltern und Kinder
Jedes Grafikobjekt kann mit einem übergeordneten Element erstellt werden. Dadurch wird sichergestellt, dass das Element zerstört wird, wenn sein übergeordnetes Element zerstört wird. Obwohl `QGraphicsObject` sowohl von ` QObject ` als auch von ` QGraphicsItem` erbt, sollten Sie zur Verwaltung der Beziehungen zwischen übergeordneten und untergeordneten Elementen die von ` QGraphicsItem` bereitgestellten Funktionen verwenden, nicht die von ` QObject`.
Die Beziehungen zwischen Elementen lassen sich mit den Funktionen ` parentItem()` und ` childItems()` untersuchen. In der Hierarchie der Elemente einer Szene entsprechen die Funktionen ` parentObject()` und ` parentWidget()` den Funktionen ` QWidget::parent()` und ` QWidget::parentWidget()` für Unterklassen von ` QWidget `.
Siehe auch QGraphicsWidget.
Dokumentation zu Eigenschaften
effect : QGraphicsEffect*
Diese Eigenschaft enthält den mit diesem Element verknüpften Effekt
Siehe auch QGraphicsItem::setGraphicsEffect() und QGraphicsItem::graphicsEffect().
enabled : bool
Diese Eigenschaft gilt unabhängig davon, ob das Element aktiviert ist oder nicht
Diese Eigenschaft ist in „ QGraphicsItem “ deklariert.
Standardmäßig ist diese Eigenschaft auf „ true “ gesetzt.
Notifier-Signal:
| void | enabledChanged() |
Siehe auch „ QGraphicsItem::isEnabled()“ und „ QGraphicsItem::setEnabled()“.
opacity : qreal
Diese Eigenschaft gibt die Deckkraft des Elements an
Benachrichtigungssignal:
| void | opacityChanged() |
Siehe auch „ QGraphicsItem::setOpacity()“ und „ QGraphicsItem::opacity()“.
parent : QGraphicsObject*
Diese Eigenschaft enthält das übergeordnete Element des Objekts
Hinweis: Das übergeordnete Element des Elements wird unabhängig von dem über „ QObject::parent()“ zurückgegebenen übergeordneten Objekt festgelegt.
Notifier-Signal:
| void | parentChanged() |
Siehe auch „ QGraphicsItem::setParentItem()“ und „ QGraphicsItem::parentObject()“.
pos : QPointF
Diese Eigenschaft gibt die Position des Elements an
Beschreibt die Position des Elements.
Siehe auch QGraphicsItem::setPos() und QGraphicsItem::pos().
rotation : qreal
Diese Eigenschaft gibt die Drehung des Elements in Grad an.
Hiermit wird festgelegt, um wie viele Grad das Element um seinen transformOrigin gedreht werden soll. Die Standarddrehung beträgt 0 Grad (d. h. es findet keine Drehung statt).
Notifier-Signal:
| void | rotationChanged() |
scale : qreal
Diese Eigenschaft legt den Maßstab des Elements fest.
Ein Skalierungsfaktor kleiner als 1 bedeutet, dass das Element kleiner als normal angezeigt wird, und ein Skalierungsfaktor größer als 1 bedeutet, dass das Element größer als normal angezeigt wird. Ein negativer Skalierungsfaktor bedeutet, dass das Element gespiegelt wird.
Standardmäßig werden Elemente mit einem Skalierungsfaktor von 1 (d. h. in ihrer normalen Größe) angezeigt.
Die Skalierung erfolgt ausgehend vom transformOrigin des Elements.
Notifier-Signal:
| void | scaleChanged() |
transformOriginPoint : QPointF
Diese Eigenschaft legt den Transformationsursprung fest
Diese Eigenschaft legt einen bestimmten Punkt im Koordinatensystem des Elements als Ursprung für Skalierung und Drehung fest.
Siehe auch „ scale“ , „ rotation “ und „ QGraphicsItem::transformOriginPoint()“.
visible : bool
Diese Eigenschaft gilt unabhängig davon, ob das Element sichtbar ist oder nicht
Diese Eigenschaft ist in „ QGraphicsItem “ definiert.
Standardmäßig ist diese Eigenschaft auf „ true “ gesetzt.
Notifier-Signal:
| void | visibleChanged() |
Siehe auch „ QGraphicsItem::isVisible()“ und „ QGraphicsItem::setVisible()“.
x : qreal
Diese Eigenschaft enthält die x-Position des Elements
Beschreibt die x-Position des Elements.
Benachrichtigungssignal:
| void | xChanged() |
Siehe auch QGraphicsItem::setX() und setPos().
y : qreal
Diese Eigenschaft enthält die y-Position des Elements
Beschreibt die y-Position des Elements.
Benachrichtigungssignal:
| void | yChanged() |
Siehe auch „ QGraphicsItem::setY()“ und „ setPos()“.
z : qreal
Diese Eigenschaft enthält den Z-Wert des Elements
Beschreibt den Z-Wert des Elements.
Benachrichtigungssignal:
| void | zChanged() |
Siehe auch „ QGraphicsItem::setZValue()“ und „ zValue()“.
Dokumentation der Member-Funktionen
[explicit] QGraphicsObject::QGraphicsObject(QGraphicsItem *parent = nullptr)
Erstellt ein `QGraphicsObject` mit ` parent`.
[virtual noexcept] QGraphicsObject::~QGraphicsObject()
Destruktor.
[signal] void QGraphicsObject::enabledChanged()
Dieses Signal wird immer dann ausgelöst, wenn das Element aktiviert oder deaktiviert wird.
Hinweis: Notifier -Signal für die Eigenschaft „ enabled “.
Siehe auch ` isEnabled()`.
[override virtual protected] bool QGraphicsObject::event(QEvent *ev)
Implementiert: ` QObject::event(QEvent *e)`.
void QGraphicsObject::grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags())
Registriert das Grafikobjekt bei der angegebenen „ gesture “ mit den spezifischen „ flags “.
Siehe auch ungrabGesture() und QGestureEvent.
[signal] void QGraphicsObject::opacityChanged()
Dieses Signal wird immer dann ausgelöst, wenn sich die Deckkraft des Elements ändert
Hinweis: Notifier -Signal für die Eigenschaft „ opacity “.
Siehe auch ` QGraphicsItem::opacity()`.
[signal] void QGraphicsObject::parentChanged()
Dieses Signal wird ausgelöst, sobald sich der übergeordnete Eintrag des Elements ändert
Hinweis: Notifier -Signal für die Eigenschaft „ parent “.
[signal] void QGraphicsObject::rotationChanged()
Dieses Signal wird immer dann ausgelöst, wenn sich die Drehung des Elements ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ rotation “.
[signal] void QGraphicsObject::scaleChanged()
Dieses Signal wird ausgelöst, wenn sich der Maßstab des Elements ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ scale “.
void QGraphicsObject::ungrabGesture(Qt::GestureType gesture)
Hebt die Registrierung des Grafikobjekts bei der angegebenen gesture auf.
Siehe auch „ grabGesture()“ und „ QGestureEvent “.
[protected slot] void QGraphicsObject::updateMicroFocus()
Aktualisiert den Mikrofokus des Gegenstands. Dies ist ein Slot zur Vereinfachung.
Siehe auch QInputMethod.
[signal] void QGraphicsObject::visibleChanged()
Dieses Signal wird immer dann ausgelöst, wenn sich die Sichtbarkeit des Elements ändert
Hinweis: Notifier -Signal für die Eigenschaft „ visible “.
Siehe auch „ visible “.
[signal] void QGraphicsObject::xChanged()
Dieses Signal wird immer dann ausgelöst, wenn sich die x-Position des Elements ändert
Hinweis: Notifier -Signal für die Eigenschaft „ x “.
Siehe auch ` pos()`.
[signal] void QGraphicsObject::yChanged()
Dieses Signal wird immer dann ausgelöst, wenn sich die y-Position des Elements ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ y “.
Siehe auch „ pos()“.
[signal] void QGraphicsObject::zChanged()
Dieses Signal wird immer dann ausgelöst, wenn sich der z-Wert des Elements ändert.
Hinweis: Notifier -Signal für die Eigenschaft „ z “.
Siehe auch ` pos()`.
© 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.
