QGraphicsObject Class
La classe `QGraphicsObject` sert de classe de base à tous les éléments graphiques nécessitant des signaux, des slots et des propriétés. En savoir plus...
| En-tête : | #include <QGraphicsObject> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QObject et QGraphicsItem |
| Hérité 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
La classe étend une classe « QGraphicsItem » en intégrant les mécanismes de signaux/slots et de propriétés de QObject. Elle associe bon nombre des accesseurs et mutateurs de base de QGraphicsItem à des propriétés et ajoute des signaux de notification pour bon nombre d’entre eux.
Parents et enfants
Chaque objet graphique peut être instancié avec un élément parent. Cela garantit que l’objet sera détruit lorsque son élément 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 par ` 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 associé à cet élément
Voir également QGraphicsItem::setGraphicsEffect() et QGraphicsItem::graphicsEffect().
enabled : bool
Cette propriété s'applique que l'élément soit activé ou non
Cette propriété est déclarée dans QGraphicsItem.
Par défaut, cette propriété est définie sur « true ».
Signal de notification :
| void | enabledChanged() |
Voir également ` QGraphicsItem::isEnabled()` et ` QGraphicsItem::setEnabled()`.
opacity : qreal
Cette propriété définit l'opacité de l'élément
Signal de notification :
| 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 la méthode ` QObject::parent()` ().
Signal de notification :
| void | parentChanged() |
Voir également QGraphicsItem::setParentItem() et QGraphicsItem::parentObject().
pos : QPointF
Cette propriété indique 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 spécifie de combien de degrés l'élément doit pivoter autour de son point d'origine de transformation. La rotation par défaut est de 0 degré (c'est-à-dire qu'il n'y a pas de rotation).
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 s'affichera plus petit que la normale, tandis qu'une échelle supérieure à 1 signifie qu'il s'affichera plus grand que la normale. Une échelle négative signifie que l'élément sera inversé.
Par défaut, les éléments sont affichés à une échelle de 1 (c'est-à-dire à leur taille normale).
La mise à l'échelle s'effectue à partir du point de transformation (transformOrigin) de l'élément.
Signal de notification :
| void | scaleChanged() |
transformOriginPoint : QPointF
Cette propriété définit l'origine de la transformation
Cette propriété définit un point spécifique du système de coordonnées de l'élément comme origine pour la mise à l'échelle et la rotation.
Voir également scale, rotation et QGraphicsItem::transformOriginPoint().
visible : bool
Cette propriété s'applique que l'élément soit visible ou non
Cette propriété est déclarée dans QGraphicsItem.
Par défaut, cette propriété est définie sur « true ».
Signal de notification :
| 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 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 sur les fonctions membres
[explicit] QGraphicsObject::QGraphicsObject(QGraphicsItem *parent = nullptr)
Crée un objet QGraphicsObject à l'aide de la fonction ` parent`.
[virtual noexcept] QGraphicsObject::~QGraphicsObject()
Destructeur.
[signal] void QGraphicsObject::enabledChanged()
Ce signal est émis chaque fois que l'élément est activé ou désactivé.
Remarque : signalde 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'gesture donné avec l'flags spécifique.
Voir également ungrabGesture() et QGestureEvent.
[signal] void QGraphicsObject::opacityChanged()
Ce signal est émis chaque fois que l'opacité de l'élément change
Remarque : signalde notification pour la propriété opacity.
Voir également ` QGraphicsItem::opacity()`.
[signal] void QGraphicsObject::parentChanged()
Ce signal est émis chaque fois que l'élément parent de l'élément change
Remarque : signalNotifier pour la propriété parent.
[signal] void QGraphicsObject::rotationChanged()
Ce signal est émis chaque fois que la rotation de l'élément change.
Remarque : signalde notification pour la propriété « rotation ».
[signal] void QGraphicsObject::scaleChanged()
Ce signal est émis lorsque l'échelle de l'élément change.
Remarque : signalde notification pour la propriété scale.
void QGraphicsObject::ungrabGesture(Qt::GestureType gesture)
Désabonne l'objet graphique de l'gesture spécifiée.
Voir également grabGesture() et QGestureEvent.
[protected slot] void QGraphicsObject::updateMicroFocus()
Met à jour le micro-focus de l'objet. Cet emplacement est prévu pour plus de commodité.
Voir également QInputMethod.
[signal] void QGraphicsObject::visibleChanged()
Ce signal est émis chaque fois que la visibilité de l'élément change
Remarque : signalde notification pour la propriété visible.
Voir également visible.
[signal] void QGraphicsObject::xChanged()
Ce signal est émis chaque fois que la position x de l'élément change
Remarque : signalde notification pour la propriété x.
Voir également ` pos()`.
[signal] void QGraphicsObject::yChanged()
Ce signal est émis chaque fois que la position y de l'élément change.
Remarque : signalde notification pour la propriété y.
Voir également ` pos()`.
[signal] void QGraphicsObject::zChanged()
Ce signal est émis chaque fois que la valeur z de l'élément change.
Remarque : signalde notification pour la propriété z.
Voir aussi ` 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.
