QGraphicsObject

La classe QGraphicsObject est une classe de base pour tous les éléments graphiques utilisant des signaux, des slots et des propriétés. Plus d'informations...

#include <QGraphicsObject>

Voir la position dans l'arbre des classes.

Héritage

Hérite de QObject et QGraphicsItem.

Hérité par QDeclarativeItem, QGraphicsSvgItem, QGraphicsTextItem et QGraphicsWidget.

Cette classe a été introduite dans Qt 4.6.

Description détaillée

La classe QGraphicsObject est une classe de base pour tous les éléments graphiques utilisant des signaux, des slots et des propriétés.

La classe étend QGraphicsItem avec les mécanismes signal/slot et propriétés de QObject. Elle possède des propriétés correspondant aux modificateurs et accesseurs de base de QGraphicsItem et ajoute des signaux de notification pour une grande partie d'entre eux.

Parents et enfants

Chaque objet graphique peut être construit avec un élément parent. Cela garantit que l'élément sera détruit en même temps que l'élément parent. Bien que QGraphicsObject dérive à la fois de QObject et de QGraphicsItem, vous devez utiliser les fonctions fournies par QGraphicsItem, et pas celles de QObject, pour gérer les relations entres les éléments parents et enfants.

Les relations entre éléments peuvent être explorées en utilisant les fonctions parentItem() et childItems(). Dans la hiérarchie des éléments d'une scène, les fonctions parentObject() et parentWidget() sont les équivalents des fonctions QWidget::parent() et QWidget::parentWidget() pour les classes dérivées de QWidget.

Voir aussi QGraphicsWidget.

Propriétés

effect : QGraphicsEffect * const

Cette propriété contient l'effet attaché à cet élément.

Cette propriété a été introduite dans Qt 4.7.

Voir aussi QGraphicsItem::setGraphicsEffect() et QGraphicsItem::graphicsEffect().

enabled : const bool

Cette propriété est définie à truesi l'élément est activé, false sinon.

Cette propriété est déclarée dans QGraphicsItem.

Par défaut, cette propriété est true.

Signal de notification :

void enabledChanged ()

Voir aussi QGraphicsItem::isEnabled(), QGraphicsItem::setEnabled() et QGraphicsObject::enabledChanged().

opacity : const qreal

Cette propriété contient l'opacité de l'élément.

Signal de notification :

void opacityChanged ()

Voir aussi QGraphicsItem::setOpacity() et QGraphicsItem::opacity().

parent : QGraphicsObject * const

Cette propriété contient le parent de l'élément.

Note : le parent de l'élément est défini indépendamment de l'objet parent renvoyé par QObject::parent().

Signal de notification :

void parentChanged ()

Voir aussi QGraphicsItem::setParentItem() et QGraphicsItem::parentObject().

pos : const QPointF

Cette propriété contient la position de l'élément.

Voir aussi QGraphicsItem::setPos() et QGraphicsItem::pos().

rotation : const qreal

Cette propriété contient la rotation de l'élément en degrés autour de l'axe transformOrigin. La rotation par défaut est de 0 degré (c'est-à-dire aucune rotation).

Signal de notification :

void rotationChanged ()

scale : const qreal

Cette propriété contient l'échelle de l'élément.

Une échelle de moins de 1 signifie que l'élément sera affiché en taille réduite et une échelle de plus de 1 qu'il sera agrandi. Une échelle négative affichera l'élément en miroir.

Par défaut, les éléments sont affichés avec une échelle de 1 (c'est-à-dire à leur taille normale).

La mise à l'échelle se fait à partir du point transformOrigin.

Signal de notification :

void scaleChanged ()

transformOriginPoint : const QPointF

Cette propriété contient l'origine de la transformation.

Cette propriété définit un point dans le système de coordonnées de l'élément qui sera l'origine pour les redimensionnements et les rotations.

Voir aussi scale, rotation et QGraphicsItem::transformOriginPoint().

visible : const bool

Cette propriété est définie à true si l'élément est visible, false sinon.

Cette propriété est déclarée dans QGraphicsItem.

Par défaut, cette propriété est true.

Signal de notification :

void visibleChanged ()

Voir aussi QGraphicsItem::isVisible(), QGraphicsItem::setVisible() et visibleChanged().

x : const qreal

Cette propriété contient la position x de l'élément.

Signal de notification :

void xChanged ()

Voir aussi QGraphicsItem::setX(), setPos() et xChanged().

y : const qreal

Cette propriété contient la position y de l'élément.

Signal de notification :

void yChanged ()

Voir aussi QGraphicsItem::setY(), setPos() et yChanged().

z : const qreal

Cette propriété contient la valeur z de l'élément.

Signal de notification :

void zChanged ()

Voir aussi QGraphicsItem::setZValue(), zValue() et zChanged().

Fonctions membres

QGraphicsObject::QGraphicsObject ( QGraphicsItem * parent = 0 )

Construit un QGraphicsObject avec parent comme parent.

void QGraphicsObject::enabledChanged () [signal]

Ce signal est émis à chaque fois que l'élément est activé ou désactivé.

Voir aussi isEnabled().

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

Associe l'objet graphique au geste gesture donné avec les drapeaux spécifiques flags.

Voir aussi ungrabGesture() et QGestureEvent.

void QGraphicsObject::opacityChanged () [signal]

Ce signal est émis à chaque fois que l'opacité de l'élément change.

Voir aussi QGraphicsItem::opacity().

void QGraphicsObject::parentChanged () [signal]

Ce signal est émis à chaque fois que le parent de l'élément change.

void QGraphicsObject::rotationChanged () [signal]

Ce signal est émis à chaque fois que la rotation de l'élément change.

void QGraphicsObject::scaleChanged () [signal]

Ce signal est émis quand l'échelle de l'élément change.

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

Annule l'association entre l'objet graphique et le geste gesture donné.

Voir aussi grabGesture() et QGestureEvent.

void QGraphicsObject::updateMicroFocus () [protected slot]

Met à jour le micro focus de l'élément. Cette fonction est un slot pour un usage plus commode.

Cette fonction a été introduite dans Qt 4.7.

Voir aussi QInputContext.

void QGraphicsObject::visibleChanged () [signal]

Ce signal est émis à chaque fois que la visibilité de l'élément change.

Voir aussi visible.

void QGraphicsObject::xChanged () [signal]

Ce signal est émis à chaque fois que la position x de l'élément change.

Voir aussi pos().

void QGraphicsObject::yChanged () [signal]

Ce signal est émis à chaque fois que la position y de l'élément change.

Voir aussi pos().

void QGraphicsObject::zChanged () [signal]

Ce signal est émis à chaque fois que la valeur z de l'élément change.

Voir aussi pos().

Remerciements

Merci à Ilya Diallo pour la traduction et à Dimitry Ernot ainsi qu'à Jacques Thery pour leur relecture !