QGraphicsObject Class

Die Klasse QGraphicsObject bietet eine Basisklasse für alle grafischen Elemente, die Signale, Slots und Eigenschaften benötigen. Mehr...

Kopfzeile: #include <QGraphicsObject>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Erbt: QObject und QGraphicsItem
Geerbt von:

QGraphicsSvgItem, QGraphicsTextItem, und QGraphicsWidget

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()

Reimplementierte geschützte Funktionen

virtual bool event(QEvent *ev) override

Geschützte Steckplätze

Detaillierte Beschreibung

Die Klasse erweitert QGraphicsItem um die Signal/Slot- und Eigenschaftsmechanismen von QObject. Sie bildet viele der grundlegenden Setter und Getter von QGraphicsItem auf Eigenschaften ab und fügt Benachrichtigungssignale für viele von ihnen hinzu.

Eltern und Kinder

Jedes Grafikobjekt kann mit einem übergeordneten Element erstellt werden. Dadurch wird sichergestellt, dass das Objekt zerstört wird, wenn sein Elternobjekt zerstört wird. Obwohl QGraphicsObject sowohl von QObject als auch von QGraphicsItem erbt, sollten Sie die von QGraphicsItem und nicht von QObject bereitgestellten Funktionen verwenden, um die Beziehungen zwischen übergeordneten und untergeordneten Elementen zu verwalten.

Die Beziehungen zwischen Elementen können mit den Funktionen parentItem() und childItems() untersucht werden. In der Hierarchie der Elemente in einer Szene sind die Funktionen parentObject() und parentWidget() das Äquivalent zu den Funktionen QWidget::parent() und QWidget::parentWidget() für QWidget Unterklassen.

Siehe auch QGraphicsWidget.

Dokumentation der Eigenschaften

effect : QGraphicsEffect* const

Diese Eigenschaft enthält den Effekt, der mit diesem Element verbunden ist

Siehe auch QGraphicsItem::setGraphicsEffect() und QGraphicsItem::graphicsEffect().

enabled : const bool

Diese Eigenschaft gibt an, ob das Element aktiviert ist oder nicht

Diese Eigenschaft wird in QGraphicsItem angegeben.

Standardmäßig ist diese Eigenschaft true.

Benachrichtigungssignal:

Siehe auch QGraphicsItem::isEnabled() und QGraphicsItem::setEnabled().

opacity : const qreal

Diese Eigenschaft enthält die Deckkraft des Elements

Benachrichtigungssignals:

Siehe auch QGraphicsItem::setOpacity() und QGraphicsItem::opacity().

parent : QGraphicsObject* const

Diese Eigenschaft enthält das übergeordnete Objekt des Elements

Hinweis: Das übergeordnete Element wird unabhängig von dem übergeordneten Objekt gesetzt, das von QObject::parent() zurückgegeben wird.

Benachrichtigungssignal:

void parentChanged()

Siehe auch QGraphicsItem::setParentItem() und QGraphicsItem::parentObject().

pos : const QPointF

Diese Eigenschaft enthält die Position des Elements

Beschreibt die Position des Elements.

Siehe auch QGraphicsItem::setPos() und QGraphicsItem::pos().

rotation : const qreal

Diese Eigenschaft gibt die Drehung des Objekts in Grad an.

Sie gibt an, um wie viele Grad das Element um seinen transformOrigin gedreht werden soll. Die Standarddrehung ist 0 Grad (d.h. überhaupt nicht gedreht).

Benachrichtigungssignal:

scale : const qreal

Diese Eigenschaft gibt den Maßstab des Objekts an.

Ein Maßstab von weniger als 1 bedeutet, dass das Element kleiner als normal angezeigt wird, und ein Maßstab von mehr als 1 bedeutet, dass das Element größer als normal angezeigt wird. Ein negativer Maßstab bedeutet, dass das Element gespiegelt wird.

Standardmäßig werden Objekte mit einem Maßstab von 1 angezeigt (d. h. in ihrer normalen Größe).

Die Skalierung ergibt sich aus dem transformOrigin des Elements.

Benachrichtigungssignal:

void scaleChanged()

transformOriginPoint : const QPointF

Diese Eigenschaft enthält den Ursprung der Transformation

Mit dieser Eigenschaft wird ein bestimmter Punkt im Koordinatensystem des Objekts als Ursprung für Skalierung und Drehung festgelegt.

Siehe auch scale, rotation, und QGraphicsItem::transformOriginPoint().

visible : const bool

Diese Eigenschaft gibt an, ob das Element sichtbar ist oder nicht

Diese Eigenschaft wird in QGraphicsItem angegeben.

Standardmäßig ist diese Eigenschaft true.

Benachrichtigungssignal:

Siehe auch QGraphicsItem::isVisible() und QGraphicsItem::setVisible().

x : const qreal

Diese Eigenschaft enthält die x-Position des Objekts

Beschreibt die x-Position des Elements.

Benachrichtigungssignal:

void xChanged()

Siehe auch QGraphicsItem::setX() und setPos().

y : const qreal

Diese Eigenschaft enthält die y-Position des Objekts

Beschreibt die y-Position des Elements.

Benachrichtigungssignal:

void yChanged()

Siehe auch QGraphicsItem::setY() und setPos().

z : const qreal

Diese Eigenschaft enthält den z-Wert des Objekts

Beschreibt den z-Wert des Objekts.

Benachrichtigungssignal:

void zChanged()

Siehe auch QGraphicsItem::setZValue() und zValue().

Dokumentation der Mitgliedsfunktionen

[explicit] QGraphicsObject::QGraphicsObject(QGraphicsItem *parent = nullptr)

Konstruiert ein QGraphicsObject mit parent.

[virtual noexcept] QGraphicsObject::~QGraphicsObject()

Zerstörer.

[signal] void QGraphicsObject::enabledChanged()

Dieses Signal wird ausgesendet, wenn das Element aktiviert oder deaktiviert wird.

Hinweis: Benachrichtigungssignal für die Eigenschaft enabled.

Siehe auch isEnabled().

[override virtual protected] bool QGraphicsObject::event(QEvent *ev)

Reimplements: QObject::event(QEvent *e).

void QGraphicsObject::grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags())

Abonniert das Grafikobjekt auf das angegebene gesture mit spezifischer flags.

Siehe auch ungrabGesture() und QGestureEvent.

[signal] void QGraphicsObject::opacityChanged()

Dieses Signal wird immer dann ausgegeben, wenn sich die Deckkraft des Elements ändert

Hinweis: Benachrichtigungssignal für die Eigenschaft opacity.

Siehe auch QGraphicsItem::opacity().

[signal] void QGraphicsObject::parentChanged()

Dieses Signal wird immer dann ausgegeben, wenn sich das übergeordnete Element des Elements ändert

Hinweis: Benachrichtigungssignal für die Eigenschaft parent.

[signal] void QGraphicsObject::rotationChanged()

Dieses Signal wird immer dann ausgegeben, wenn sich die Drehung des Objekts ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft rotation.

[signal] void QGraphicsObject::scaleChanged()

Dieses Signal wird ausgegeben, wenn sich der Maßstab des Elements ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft scale.

void QGraphicsObject::ungrabGesture(Qt::GestureType gesture)

Meldet das Grafikobjekt von der angegebenen gesture ab.

Siehe auch grabGesture() und QGestureEvent.

[protected slot] void QGraphicsObject::updateMicroFocus()

Aktualisiert den Mikrofokus des Objekts. Dies ist ein Schlitz für die Bequemlichkeit.

Siehe auch QInputMethod.

[signal] void QGraphicsObject::visibleChanged()

Dieses Signal wird immer dann ausgegeben, wenn sich die Sichtbarkeit des Elements ändert

Hinweis: Benachrichtigungssignal für die Eigenschaft visible.

Siehe auch visible.

[signal] void QGraphicsObject::xChanged()

Dieses Signal wird immer dann ausgegeben, wenn sich die x-Position des Elements ändert

Hinweis: Benachrichtigungssignal für die Eigenschaft x.

Siehe auch pos().

[signal] void QGraphicsObject::yChanged()

Dieses Signal wird ausgegeben, wenn sich die y-Position des Elements ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft y.

Siehe auch pos().

[signal] void QGraphicsObject::zChanged()

Dieses Signal wird ausgegeben, wenn sich der z-Wert des Elements ändert.

Hinweis: Benachrichtigungssignal für die Eigenschaft z.

Siehe auch pos().

© 2025 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.