QGraphicsObject Class
La classe QGraphicsObject est une classe de base pour tous les éléments graphiques qui nécessitent des signaux, des emplacements et des propriétés. Plus d'informations...
| En-tête : | #include <QGraphicsObject> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite : | QObject et QGraphicsItem |
| Héritée par : |
Propriétés
Fonctions publiques
| QGraphicsObject(QGraphicsItem *parent = nullptr) | |
| virtual | ~QGraphicsObject() |
| void | grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags()) |
| void | ungrabGesture(Qt::GestureType gesture) |
Signaux
| void | enabledChanged() |
| void | opacityChanged() |
| void | parentChanged() |
| void | rotationChanged() |
| void | scaleChanged() |
| void | visibleChanged() |
| void | xChanged() |
| void | yChanged() |
| void | zChanged() |
Fonctions protégées réimplémentées
| virtual bool | event(QEvent *ev) override |
Emplacements protégés
| void | updateMicroFocus() |
Description détaillée
Cette classe étend un site QGraphicsItem avec les mécanismes de signal/emplacement et de propriété de QObject. Elle associe de nombreux setters et getters de base de QGraphicsItem à des propriétés et ajoute des signaux de notification pour un grand nombre d'entre elles.
Parents et enfants
Chaque objet graphique peut être construit avec un élément parent. Cela garantit que l'objet sera détruit lorsque l'objet parent sera détruit. Bien que QGraphicsObject hérite à la fois de QObject et de QGraphicsItem, vous devez utiliser les fonctions fournies par QGraphicsItem, et non QObject, pour gérer les relations entre les éléments parents et enfants.
Les relations entre les éléments peuvent être explorées à l'aide des fonctions parentItem() et childItems(). Dans la hiérarchie des éléments d'une scène, les fonctions parentObject() et parentWidget() sont l'équivalent des fonctions QWidget::parent() et QWidget::parentWidget() pour les sous-classes de QWidget.
Voir également QGraphicsWidget.
Documentation sur les propriétés
effect : QGraphicsEffect*
Cette propriété contient l'effet attaché à cet élément
Voir aussi QGraphicsItem::setGraphicsEffect() et QGraphicsItem::graphicsEffect().
enabled : bool
Cette propriété indique si l'élément est activé ou non
Cette propriété est déclarée dans QGraphicsItem.
Par défaut, la valeur de cette propriété est true.
Notifier signal :
| void | enabledChanged() |
Voir également QGraphicsItem::isEnabled() et QGraphicsItem::setEnabled().
opacity : qreal
Cette propriété définit l'opacité de l'élément
Notifier :
| void | opacityChanged() |
Voir également QGraphicsItem::setOpacity() et QGraphicsItem::opacity().
parent : QGraphicsObject*
Cette propriété contient le parent de l'élément
Remarque : le parent de l'élément est défini indépendamment de l'objet parent renvoyé par QObject::parent().
Notifier :
| void | parentChanged() |
Voir également QGraphicsItem::setParentItem() et QGraphicsItem::parentObject().
pos : QPointF
Cette propriété contient la position de l'élément
Décrit la position de l'élément.
Voir également QGraphicsItem::setPos() et QGraphicsItem::pos().
rotation : qreal
Cette propriété indique la rotation de l'élément en degrés.
Elle indique le nombre de degrés de rotation de l'élément autour de son transformOrigin. La rotation par défaut est de 0 degré (c'est-à-dire qu'il n'y a pas de rotation du tout).
Signal de notification :
| void | rotationChanged() |
scale : qreal
Cette propriété définit l'échelle de l'élément.
Une échelle inférieure à 1 signifie que l'élément sera affiché plus petit que la normale, et une échelle supérieure à 1 signifie que l'élément sera affiché plus grand que la normale. Une échelle négative signifie que l'élément sera reflété.
Par défaut, les éléments sont affichés à une échelle de 1 (c'est-à-dire à leur taille normale).
La mise à l'échelle se fait à partir de la transformOrigin de l'élément.
Signal Notificateur :
| void | scaleChanged() |
transformOriginPoint : QPointF
Cette propriété contient l'origine de la transformation
Cette propriété définit un point spécifique dans le système de coordonnées de l'élément comme origine pour l'échelle et la rotation.
Voir aussi scale, rotation, et QGraphicsItem::transformOriginPoint().
visible : bool
Cette propriété indique si l'élément est visible ou non
Cette propriété est déclarée dans QGraphicsItem.
Par défaut, la valeur de cette propriété est true.
Notifier signal :
| void | visibleChanged() |
Voir également QGraphicsItem::isVisible() et QGraphicsItem::setVisible().
x : qreal
Cette propriété contient la position x de l'élément
Décrit la position x de l'élément.
Signal de notification :
| void | xChanged() |
Voir également QGraphicsItem::setX() et setPos().
y : qreal
Cette propriété contient la position y de l'élément
Décrit la position en y de l'élément.
Signal de notification :
| void | yChanged() |
Voir également QGraphicsItem::setY() et setPos().
z : qreal
Cette propriété contient la valeur z de l'élément
Décrit la valeur z de l'élément.
Signal de notification :
| void | zChanged() |
Voir également QGraphicsItem::setZValue() et zValue().
Documentation des fonctions membres
[explicit] QGraphicsObject::QGraphicsObject(QGraphicsItem *parent = nullptr)
Construit un QGraphicsObject avec parent.
[virtual noexcept] QGraphicsObject::~QGraphicsObject()
Destructeur.
[signal] void QGraphicsObject::enabledChanged()
Ce signal est émis lorsque l'élément est activé ou désactivé.
Note : Signal de notification pour la propriété enabled.
Voir également isEnabled().
[override virtual protected] bool QGraphicsObject::event(QEvent *ev)
Réimplémente : QObject::event(QEvent *e).
void QGraphicsObject::grabGesture(Qt::GestureType gesture, Qt::GestureFlags flags = Qt::GestureFlags())
Abonne l'objet graphique à l'adresse gesture avec une adresse spécifique flags.
Voir également ungrabGesture() et QGestureEvent.
[signal] void QGraphicsObject::opacityChanged()
Ce signal est émis lorsque l'opacité de l'élément change
Note : Signal de notification pour la propriété opacity.
Voir également QGraphicsItem::opacity().
[signal] void QGraphicsObject::parentChanged()
Ce signal est émis lorsque le parent de l'élément change.
Note : Signal de notification pour la propriété parent.
[signal] void QGraphicsObject::rotationChanged()
Ce signal est émis lorsque la rotation de l'élément change.
Note : Signal de notification pour la propriété rotation.
[signal] void QGraphicsObject::scaleChanged()
Ce signal est émis lorsque l'échelle de l'élément change.
Note : Signal de notification pour la propriété scale.
void QGraphicsObject::ungrabGesture(Qt::GestureType gesture)
Désinscrit l'objet graphique du site gesture.
Voir aussi grabGesture() et QGestureEvent.
[protected slot] void QGraphicsObject::updateMicroFocus()
Met à jour la micro-focalisation de l'élément. Il s'agit d'une fente pour des raisons de commodité.
Voir également QInputMethod.
[signal] void QGraphicsObject::visibleChanged()
Ce signal est émis lorsque la visibilité de l'élément change.
Note : Signal de notification pour la propriété visible.
Voir également visible.
[signal] void QGraphicsObject::xChanged()
Ce signal est émis lorsque la position x de l'élément change.
Note : Signal de notification pour la propriété x.
Voir également pos().
[signal] void QGraphicsObject::yChanged()
Ce signal est émis lorsque la position y de l'élément change.
Note : Signal de notification pour la propriété y.
Voir également pos().
[signal] void QGraphicsObject::zChanged()
Ce signal est émis lorsque la valeur z de l'élément change.
Note : Signal de notification pour la propriété z.
Voir également 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.
