QQuickItem Class

Documentation des fonctions membres

[explicit] QQuickItem::QQuickItem(QQuickItem *parent = nullptr)

Construit un QQuickItem avec l'adresse parent donnée.

Le parent sera utilisé comme parent du visual parent et du QObject.

[override virtual noexcept] QQuickItem::~QQuickItem()

Détruit le site QQuickItem.

bool QQuickItem::acceptHoverEvents() const

Indique si les événements de survol sont acceptés par cet élément.

La valeur par défaut est false.

Si cette valeur est false, l'élément ne recevra aucun événement de survol par l'intermédiaire des fonctions hoverEnterEvent(), hoverMoveEvent() et hoverLeaveEvent().

Voir également setAcceptHoverEvents().

bool QQuickItem::acceptTouchEvents() const

Indique si les événements tactiles sont acceptés par cet élément.

La valeur par défaut est false.

Si cette valeur est false, l'élément ne recevra aucun événement tactile par l'intermédiaire de la fonction touchEvent().

Voir également setAcceptTouchEvents().

Qt::MouseButtons QQuickItem::acceptedMouseButtons() const

Renvoie les boutons de souris acceptés par cet élément.

La valeur par défaut est Qt::NoButton; c'est-à-dire qu'aucun bouton de souris n'est accepté.

Si un élément n'accepte pas le bouton de la souris pour un événement de souris particulier, l'événement de souris ne sera pas transmis à l'élément et sera transmis à l'élément suivant dans la hiérarchie des éléments.

Voir également setAcceptedMouseButtons() et acceptTouchEvents().

[virtual] QRectF QQuickItem::boundingRect() const

Renvoie les dimensions de l'élément dans son propre système de coordonnées : un rectangle allant de 0, 0 à width() et height().

[invokable] QQuickItem *QQuickItem::childAt(qreal x, qreal y) const

Renvoie le premier élément enfant visible trouvé au point (x, y) dans le système de coordonnées de cet élément.

Retourne nullptr s'il n'existe pas d'élément de ce type.

QList<QQuickItem *> QQuickItem::childItems() const

Renvoie les enfants de cet élément.

[virtual protected] bool QQuickItem::childMouseEventFilter(QQuickItem *item, QEvent *event)

Réimplémentez cette méthode pour filtrer les événements de pointeur reçus par les enfants de cet élément.

Cette méthode ne sera appelée que si filtersChildMouseEvents() est true.

Elle renvoie true si l'événement event spécifié ne doit pas être transmis à l'enfant item spécifié, et false dans le cas contraire. Si vous renvoyez true, vous devez également renvoyer accept ou ignore le event, pour indiquer si la propagation des événements doit s'arrêter ou se poursuivre. L'adresse event sera cependant toujours envoyée à tous les ChildMouseEventFilters de la chaîne parentale.

Voir également setFiltersChildMouseEvents().

[override virtual protected] void QQuickItem::classBegin()

Réimplémente : QQmlParserStatus::classBegin().

Les classes dérivées doivent appeler la méthode de la classe de base avant d'ajouter leur propre action à effectuer à classBegin.

[virtual] QRectF QQuickItem::clipRect() const

Renvoie la zone rectangulaire de cet élément qui est actuellement visible dans viewportItem(), s'il existe une fenêtre de visualisation et si l'indicateur ItemObservesViewport est activé ; sinon, l'étendue de cet élément dans son propre système de coordonnées : un rectangle allant de 0, 0 à width() et height(). Il s'agit de la région destinée à rester visible si clip est true. Elle peut également être utilisée dans updatePaintNode() pour limiter les graphiques ajoutés au graphe de scène.

Par exemple, un grand dessin ou un grand document texte peut être affiché dans un Flickable qui n'occupe qu'une partie de la fenêtre de l'application : dans ce cas, Flickable est l'élément viewport, et un élément de rendu de contenu personnalisé peut choisir d'omettre les nœuds du graphe de scène qui se trouvent en dehors de la zone actuellement visible. Si le drapeau ItemObservesViewport est activé, cette zone changera chaque fois que l'utilisateur fera défiler le contenu de l'élément Flickable.

Dans le cas d'éléments de fenêtre imbriqués, clipRect() est l'intersection des boundingRectde tous les ancêtres pour lesquels l'indicateur ItemIsViewport est activé, dans le système de coordonnées de cet élément.

Voir également boundingRect().

[override virtual protected] void QQuickItem::componentComplete()

Réimplémente : QQmlParserStatus::componentComplete().

Les classes dérivées doivent appeler la méthode de la classe de base avant d'ajouter leurs propres actions à exécuter à componentComplete.

[virtual invokable] bool QQuickItem::contains(const QPointF &point) const

Renvoie true si cet élément contient point, qui est en coordonnées locales ; renvoie false dans le cas contraire.

Cette fonction peut être surchargée afin de gérer les collisions de points dans les éléments ayant des formes personnalisées. L'implémentation par défaut vérifie si le point se trouve à l'intérieur de containmentMask() s'il est défini, ou à l'intérieur de la boîte de délimitation dans le cas contraire.

QCursor QQuickItem::cursor() const

Renvoie la forme du curseur pour cet élément.

Le curseur de la souris prendra cette forme lorsqu'il sera au-dessus de cet élément, à moins qu'un curseur prioritaire ne soit défini. Voir list of predefined cursor objects pour une gamme de formes utiles.

Si aucune forme de curseur n'a été définie, cette fonction renvoie un curseur ayant la forme Qt::ArrowCursor. Toutefois, une autre forme de curseur peut être affichée si un élément qui se chevauche a un curseur valide.

Voir également setCursor() et unsetCursor().

[virtual protected] void QQuickItem::dragEnterEvent(QDragEnterEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de glisser-déposer d'un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

Les événements de glisser-déposer ne sont fournis que si l'indicateur ItemAcceptsDrops a été activé pour cet élément.

L'événement est accepté par défaut, il n'est donc pas nécessaire de l'accepter explicitement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

Voir également Drag et Drag and Drop.

[virtual protected] void QQuickItem::dragLeaveEvent(QDragLeaveEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de glissement et de sortie d'un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

Les événements de glisser-déposer ne sont fournis que si l'indicateur ItemAcceptsDrops a été activé pour cet élément.

L'événement est accepté par défaut, il n'est donc pas nécessaire de l'accepter explicitement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

Voir également Drag et Drag and Drop.

[virtual protected] void QQuickItem::dragMoveEvent(QDragMoveEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de déplacement d'un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

Les événements de glisser-déposer ne sont fournis que si l'indicateur ItemAcceptsDrops a été activé pour cet élément.

L'événement est accepté par défaut, il n'est donc pas nécessaire de l'accepter explicitement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

Voir également Drag et Drag and Drop.

[virtual protected] void QQuickItem::dropEvent(QDropEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de chute d'un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

Les événements de glisser-déposer ne sont fournis que si l'indicateur ItemAcceptsDrops a été activé pour cet élément.

L'événement est accepté par défaut, il n'est donc pas nécessaire de l'accepter explicitement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

Voir également Drag et Drag and Drop.

[invokable, since 6.3] void QQuickItem::dumpItemTree() const

Affiche quelques détails sur l'arbre visuel des éléments commençant par cet élément, de manière récursive.

Cette fonction a été introduite dans Qt 6.3.

Voir également Techniques de débogage et GammaRay's Qt Quick Inspector.

[invokable, since 6.3] void QQuickItem::ensurePolished()

Appelle updatePolish()

Cela peut être utile pour des éléments tels que les Layouts (ou Positioners) qui retardent le calcul de leurs implicitWidth et implicitHeight jusqu'à ce qu'ils reçoivent un PolishEvent.

Normalement, si, par exemple, un élément enfant est ajouté ou supprimé d'un Layout, la taille implicite n'est pas immédiatement calculée (il s'agit d'une optimisation). Dans certains cas, il peut être souhaitable d'interroger la taille implicite de la disposition juste après l'ajout d'un élément enfant. Dans ce cas, utilisez cette fonction juste avant de demander la taille implicite.

Cette fonction a été introduite dans Qt 6.3.

Voir également updatePolish() et polish().

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

Réimplémente : QObject::event(QEvent *e).

bool QQuickItem::filtersChildMouseEvents() const

Indique si les événements de pointeur destinés aux enfants de cet élément doivent être filtrés par cet élément.

Si cet élément et un élément enfant ont tous deux acceptTouchEvents() true, alors lorsqu'une interaction tactile se produit, cet élément filtrera l'événement tactile. Mais si cet élément ou l'élément enfant ne peut pas gérer les événements tactiles, childMouseEventFilter() sera appelé avec un événement souris synthétisé.

Voir également setFiltersChildMouseEvents() et childMouseEventFilter().

QQuickItem::Flags QQuickItem::flags() const

Renvoie les drapeaux de cet élément.

Voir aussi setFlags() et setFlag().

[virtual protected] void QQuickItem::focusInEvent(QFocusEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de mise au point d'un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

L'événement est accepté par défaut, il n'est donc pas nécessaire d'accepter explicitement l'événement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

Si vous réimplémentez cette fonction, vous devez appeler l'implémentation de la classe de base.

[virtual protected] void QQuickItem::focusOutEvent(QFocusEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de focus-out d'un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

L'événement est accepté par défaut, il n'est donc pas nécessaire d'accepter explicitement l'événement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

[invokable] void QQuickItem::forceActiveFocus()

Force la focalisation active sur l'élément.

Cette méthode place le focus sur l'élément et garantit que tous les objets ancêtres FocusScope dans la hiérarchie des objets reçoivent également le focus focus.

La raison du changement de focus sera Qt::OtherFocusReason. Utilisez la méthode surchargée pour spécifier la raison du focus afin de permettre une meilleure gestion du changement de focus.

Voir également activeFocus.

[invokable] void QQuickItem::forceActiveFocus(Qt::FocusReason reason)

Force la focalisation active sur l'élément avec l'adresse reason.

Cette méthode met l'accent sur l'élément et garantit que tous les objets ancêtres FocusScope dans la hiérarchie des objets reçoivent également focus.

Voir également activeFocus et Qt::FocusReason.

[virtual protected, since 6.0] void QQuickItem::geometryChange(const QRectF &newGeometry, const QRectF &oldGeometry)

Cette fonction est appelée pour gérer les changements de géométrie de cet élément de oldGeometry à newGeometry. Si les deux géométries sont identiques, elle ne fait rien.

Les classes dérivées doivent appeler la méthode de la classe de base dans leur implémentation.

Cette fonction a été introduite dans Qt 6.0.

QSharedPointer<QQuickItemGrabResult> QQuickItem::grabToImage(const QSize &targetSize = QSize())

Saisit l'élément dans une image en mémoire.

L'acquisition se fait de manière asynchrone et le signal QQuickItemGrabResult::ready() est émis lorsque l'acquisition est terminée.

Utilisez targetSize pour spécifier la taille de l'image cible. Par défaut, le résultat aura la même taille que l'élément.

Si la saisie n'a pas pu être lancée, la fonction renvoie null.

Voir également QQuickWindow::grabWindow().

[protected] bool QQuickItem::heightValid() const

Indique si la propriété "height" a été définie explicitement.

[virtual protected] void QQuickItem::hoverEnterEvent(QHoverEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de survol et d'entrée d'un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

Les événements de survol ne sont fournis que si acceptHoverEvents() est vrai.

L'événement est accepté par défaut, il n'est donc pas nécessaire de l'accepter explicitement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

[virtual protected] void QQuickItem::hoverLeaveEvent(QHoverEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de survol et de sortie d'un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

Les événements de survol ne sont fournis que si acceptHoverEvents() est vrai.

L'événement est accepté par défaut, il n'est donc pas nécessaire de l'accepter explicitement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

[virtual protected] void QQuickItem::hoverMoveEvent(QHoverEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de survol et de déplacement d'un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

Les événements de survol ne sont fournis que si acceptHoverEvents() est vrai.

L'événement est accepté par défaut, il n'est donc pas nécessaire de l'accepter explicitement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

qreal QQuickItem::implicitWidth() const

Renvoie la largeur de l'élément qui est impliquée par d'autres propriétés qui déterminent le contenu.

Voir également setImplicitWidth().

[virtual protected] void QQuickItem::inputMethodEvent(QInputMethodEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de la méthode d'entrée d'un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

L'événement est accepté par défaut, il n'est donc pas nécessaire d'accepter explicitement l'événement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

[virtual] QVariant QQuickItem::inputMethodQuery(Qt::InputMethodQuery query) const

Cette méthode ne concerne que les éléments de saisie.

Si cet élément est un élément d'entrée, cette méthode doit être réimplémentée pour renvoyer les drapeaux de méthode d'entrée pertinents pour l'élément donné query.

Voir également QWidget::inputMethodQuery().

bool QQuickItem::isAncestorOf(const QQuickItem *child) const

Renvoie true si cet élément est un ancêtre de child (c'est-à-dire si cet élément est le parent de child ou l'un des ancêtres du parent de child).

Voir aussi parentItem().

[protected] bool QQuickItem::isComponentComplete() const

Retourne true si la construction du composant QML est terminée, sinon retourne false.

Il est souvent souhaitable de retarder certains traitements jusqu'à ce que le composant soit terminé.

Voir également componentComplete().

bool QQuickItem::isFocusScope() const

Retourne true si cet élément est une portée de focus, et false dans le cas contraire.

[virtual] bool QQuickItem::isTextureProvider() const

Retourne true si cet élément est un fournisseur de texture. L'implémentation par défaut renvoie false.

Cette fonction peut être appelée depuis n'importe quel thread.

[virtual protected] void QQuickItem::itemChange(QQuickItem::ItemChange change, const QQuickItem::ItemChangeData &value)

Appelé lorsque change se produit pour cet élément.

value contient des informations supplémentaires relatives à la modification, le cas échéant.

Si vous réimplémentez cette méthode dans une sous-classe, assurez-vous d'appeler

QQuickItem::itemChange(change, value);

typiquement à la fin de votre implémentation, pour vous assurer que le signal windowChanged() sera émis.

bool QQuickItem::keepMouseGrab() const

Indique si l'entrée de la souris doit rester exclusivement sur cet élément.

Voir aussi setKeepMouseGrab(), QEvent::accept() et QEvent::ignore().

bool QQuickItem::keepTouchGrab() const

Retourne si les points de contact saisis par cet élément doivent rester exclusivement avec cet élément.

Voir aussi setKeepTouchGrab(), keepMouseGrab(), QEvent::accept() et QEvent::ignore().

[virtual protected] void QQuickItem::keyPressEvent(QKeyEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de pression sur une touche pour un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

L'événement est accepté par défaut, il n'est donc pas nécessaire d'accepter explicitement l'événement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

[virtual protected] void QQuickItem::keyReleaseEvent(QKeyEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de libération des touches d'un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

L'événement est accepté par défaut, il n'est donc pas nécessaire d'accepter explicitement l'événement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

[invokable] QPointF QQuickItem::mapFromGlobal(const QPointF &point) const

Met en correspondance le point donné point dans le système de coordonnées global de l'écran avec le point équivalent dans le système de coordonnées de cet élément, et renvoie la coordonnée mise en correspondance.

Les propriétés suivantes de l'élément sont utilisées dans le mappage : x, y, scale, rotation, transformOrigin, et transform.

Si les éléments font partie de scènes différentes, la correspondance inclut la position relative des deux scènes.

Par exemple, cela peut être utile pour ajouter une fenêtre contextuelle à un composant Qt Quick.

Voir aussi Concepts - Coordonnées visuelles dans Qt Quick.

[invokable] QPointF QQuickItem::mapFromItem(const QQuickItem *item, const QPointF &point) const

Met en correspondance le point donné point dans le système de coordonnées de item avec le point équivalent dans le système de coordonnées de cet élément, et renvoie la coordonnée mise en correspondance.

Les propriétés suivantes de l'élément sont utilisées dans la mise en correspondance : x, y, scale, rotation, transformOrigin, et transform.

Si les éléments font partie de scènes différentes, la correspondance inclut la position relative des deux scènes.

Si item est nullptr, la correspondance se fait avec point à partir du système de coordonnées de la scène.

Voir également Concepts - Coordonnées visuelles à l'adresse Qt Quick.

QPointF QQuickItem::mapFromScene(const QPointF &point) const

Met en correspondance le point point dans le système de coordonnées de la scène avec le point équivalent dans le système de coordonnées de cet élément, et renvoie la coordonnée mise en correspondance.

Les propriétés suivantes de l'élément sont utilisées dans la mise en correspondance : x, y, scale, rotation, transformOrigin, et transform.

Si les éléments font partie de scènes différentes, la correspondance inclut la position relative des deux scènes.

Voir aussi Concepts - Coordonnées visuelles dans Qt Quick.

QRectF QQuickItem::mapRectFromItem(const QQuickItem *item, const QRectF &rect) const

Met en correspondance le site rect dans le système de coordonnées de item avec la zone rectangulaire équivalente dans le système de coordonnées de cet élément, et renvoie la valeur du rectangle mis en correspondance.

Les propriétés suivantes de l'élément sont utilisées dans la mise en correspondance : x, y, scale, rotation, transformOrigin, et transform.

Si les éléments font partie de scènes différentes, la correspondance inclut la position relative des deux scènes.

Si item est nullptr, rect est mappé à partir du système de coordonnées de la scène.

Voir également Concepts - Coordonnées visuelles à l'adresse Qt Quick.

QRectF QQuickItem::mapRectFromScene(const QRectF &rect) const

Met en correspondance le site rect dans le système de coordonnées de la scène avec la zone rectangulaire équivalente dans le système de coordonnées de cet élément, et renvoie la valeur du rectangle mis en correspondance.

Les propriétés suivantes de l'élément sont utilisées dans le mappage : x, y, scale, rotation, transformOrigin, et transform.

Si les éléments font partie de scènes différentes, la correspondance inclut la position relative des deux scènes.

Voir aussi Concepts - Coordonnées visuelles dans Qt Quick.

QRectF QQuickItem::mapRectToItem(const QQuickItem *item, const QRectF &rect) const

Met en correspondance le site rect dans le système de coordonnées de cet élément avec la zone rectangulaire équivalente dans le système de coordonnées de item, et renvoie la valeur du rectangle mis en correspondance.

Les propriétés suivantes de l'élément sont utilisées dans le mappage : x, y, scale, rotation, transformOrigin, et transform.

Si les éléments font partie de scènes différentes, la correspondance inclut la position relative des deux scènes.

Si item est nullptr, rect est mappé dans le système de coordonnées de la scène.

Voir aussi Concepts - Coordonnées visuelles dans Qt Quick.

QRectF QQuickItem::mapRectToScene(const QRectF &rect) const

Met en correspondance le site rect dans le système de coordonnées de l'élément avec la zone rectangulaire équivalente dans le système de coordonnées de la scène, et renvoie la valeur du rectangle mis en correspondance.

Les propriétés suivantes de l'élément sont utilisées dans le mappage : x, y, scale, rotation, transformOrigin, et transform.

Si les éléments font partie de scènes différentes, la correspondance inclut la position relative des deux scènes.

Voir aussi Concepts - Coordonnées visuelles dans Qt Quick.

[invokable] QPointF QQuickItem::mapToGlobal(const QPointF &point) const

Met en correspondance le point point dans le système de coordonnées de l'élément avec le point équivalent dans le système de coordonnées global de l'écran et renvoie la coordonnée mise en correspondance.

Les propriétés suivantes de l'élément sont utilisées dans le mappage : x, y, scale, rotation, transformOrigin, et transform.

Si les éléments font partie de scènes différentes, la correspondance inclut la position relative des deux scènes.

Par exemple, cela peut être utile pour ajouter une fenêtre contextuelle à un composant Qt Quick.

Voir également Concepts - Coordonnées visuelles à l'adresse Qt Quick.

[invokable] QPointF QQuickItem::mapToItem(const QQuickItem *item, const QPointF &point) const

Met en correspondance le point donné point dans le système de coordonnées de cet élément avec le point équivalent dans le système de coordonnées de item, et renvoie la coordonnée mise en correspondance.

Les propriétés suivantes de l'élément sont utilisées dans la mise en correspondance : x, y, scale, rotation, transformOrigin, et transform.

Si les éléments font partie de scènes différentes, la correspondance inclut la position relative des deux scènes.

Si item est nullptr, la correspondance est établie entre point et le système de coordonnées de la scène.

Voir également Concepts - Coordonnées visuelles à l'adresse Qt Quick.

QPointF QQuickItem::mapToScene(const QPointF &point) const

Met en correspondance le point point dans le système de coordonnées de l'élément avec le point équivalent dans le système de coordonnées de la scène et renvoie la coordonnée mise en correspondance.

Les propriétés suivantes de l'élément sont utilisées dans le mappage : x, y, scale, rotation, transformOrigin, et transform.

Si les éléments font partie de scènes différentes, la correspondance inclut la position relative des deux scènes.

Voir aussi Concepts - Coordonnées visuelles dans Qt Quick.

[virtual protected] void QQuickItem::mouseDoubleClickEvent(QMouseEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de double-clic de la souris pour un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

L'événement est accepté par défaut, il n'est donc pas nécessaire d'accepter explicitement l'événement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

[virtual protected] void QQuickItem::mouseMoveEvent(QMouseEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de déplacement de la souris pour un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

Pour recevoir les événements de déplacement de la souris, l'événement précédent de pression de la souris doit être accepté (en surchargeant mousePressEvent(), par exemple) et acceptedMouseButtons() doit renvoyer le bouton de la souris correspondant.

L'événement est accepté par défaut, il n'est donc pas nécessaire de l'accepter explicitement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

[virtual protected] void QQuickItem::mousePressEvent(QMouseEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de pression de la souris pour un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

Pour recevoir les événements de pression de la souris, acceptedMouseButtons() doit renvoyer le bouton de la souris correspondant.

L'événement est accepté par défaut, il n'est donc pas nécessaire d'accepter explicitement l'événement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

[virtual protected] void QQuickItem::mouseReleaseEvent(QMouseEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de relâchement de la souris pour un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

Pour recevoir des événements de relâchement de la souris, l'événement précédent d'appui sur la souris doit être accepté (en surchargeant mousePressEvent(), par exemple) et acceptedMouseButtons() doit renvoyer le bouton de la souris correspondant.

L'événement est accepté par défaut, il n'est donc pas nécessaire de l'accepter explicitement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

[virtual protected] void QQuickItem::mouseUngrabEvent()

Ce gestionnaire d'événement peut être réimplémenté dans une sous-classe afin d'être notifié lorsqu'un événement de dégagement de la souris s'est produit sur cet élément.

[invokable] QQuickItem *QQuickItem::nextItemInFocusChain(bool forward = true)

Renvoie l'élément de la chaîne de mise au point qui est le plus proche de cet élément. Si forward est true ou n'est pas fourni, il s'agit de l'élément suivant dans la direction avant. Si forward est false, il s'agit de l'élément suivant dans le sens inverse.

void QQuickItem::polish()

Planifie un événement de polissage pour cet élément.

Lorsque le graphe de scène traite la demande, il appelle updatePolish() sur cet élément.

Voir aussi updatePolish(), QQuickTest::qIsPolishScheduled() et ensurePolished().

[virtual protected] void QQuickItem::releaseResources()

Cette fonction est appelée lorsqu'un élément doit libérer des ressources graphiques qui ne sont pas déjà gérées par les nœuds renvoyés par QQuickItem::updatePaintNode().

Cela se produit lorsque l'élément est sur le point d'être retiré de la fenêtre dans laquelle il a été rendu précédemment. L'élément est assuré d'avoir un window lorsque la fonction est appelée.

La fonction est appelée sur le fil d'exécution de l'interface graphique et l'état du fil d'exécution du rendu, lorsqu'il est utilisé, est inconnu. Les objets ne doivent pas être supprimés directement, mais plutôt programmés pour être nettoyés à l'aide de QQuickWindow::scheduleRenderJob().

Voir également Graphics Resource Handling.

QQuickItem *QQuickItem::scopedFocusItem() const

Si cet élément est une portée de focalisation, cela renvoie l'élément de sa chaîne de focalisation qui a actuellement la focalisation.

Retourne nullptr si cet élément n'est pas une portée de focalisation.

void QQuickItem::setAcceptHoverEvents(bool enabled)

Si enabled est vrai, cela permet à l'élément d'accepter les événements de survol ; sinon, les événements de survol ne sont pas acceptés par cet élément.

Voir également acceptHoverEvents().

void QQuickItem::setAcceptTouchEvents(bool enabled)

Si enabled est vrai, cela permet à l'élément d'accepter les événements tactiles ; sinon, les événements tactiles ne sont pas acceptés par cet élément.

Voir également acceptTouchEvents().

void QQuickItem::setAcceptedMouseButtons(Qt::MouseButtons buttons)

Définit les boutons de souris acceptés par cet élément à buttons.

Voir aussi acceptedMouseButtons().

void QQuickItem::setCursor(const QCursor &cursor)

Définit la forme de cursor pour cet élément.

Voir aussi cursor() et unsetCursor().

void QQuickItem::setFiltersChildMouseEvents(bool filter)

Définit si les événements de pointeur destinés aux enfants de cet élément doivent être filtrés à travers cet élément.

Si filter est vrai, childMouseEventFilter() sera appelé lorsqu'un événement de pointeur est déclenché pour un élément enfant.

Voir également filtersChildMouseEvents().

void QQuickItem::setFlag(QQuickItem::Flag flag, bool enabled = true)

Active l'indicateur flag spécifié pour cet élément si enabled est vrai ; si enabled est faux, l'indicateur est désactivé.

Par exemple, l'indicateur ItemClipsChildrenToShape indique que tous les enfants de cet élément doivent être coupés pour tenir dans la zone de l'élément.

void QQuickItem::setFlags(QQuickItem::Flags flags)

Active l'adresse flags spécifiée pour cet élément.

Voir également flags() et setFlag().

void QQuickItem::setFocusPolicy(Qt::FocusPolicy policy)

Définit la politique de mise au point de cet élément à policy.

Voir également focusPolicy().

void QQuickItem::setKeepMouseGrab(bool keep)

Définit si l'entrée de la souris doit rester exclusivement avec cet élément.

Cela est utile pour les éléments qui souhaitent saisir et conserver l'interaction de la souris en suivant un geste prédéfini. Par exemple, un élément qui s'intéresse au mouvement horizontal de la souris peut fixer keepMouseGrab à true une fois qu'un seuil a été dépassé. Une fois que keepMouseGrab a été défini comme vrai, les éléments de filtrage ne réagissent pas aux événements de la souris.

Si keep est faux, un élément de filtrage peut s'emparer de la souris. Par exemple, Flickable peut tenter de voler une saisie de souris s'il détecte que l'utilisateur a commencé à déplacer la fenêtre.

Voir également keepMouseGrab().

void QQuickItem::setKeepTouchGrab(bool keep)

Définit si les points de contact saisis par cet élément doivent rester exclusivement avec cet élément.

Cela est utile pour les éléments qui souhaitent saisir et conserver des points de contact spécifiques à la suite d'un geste prédéfini. Par exemple, un élément qui s'intéresse au mouvement horizontal des points de contact peut définir setKeepTouchGrab sur true une fois qu'un seuil a été dépassé. Une fois que setKeepTouchGrab a été fixé à true, les éléments de filtrage ne réagissent pas aux points de contact concernés.

Si keep est faux, un élément filtrant peut voler la prise. Par exemple, Flickable peut tenter de voler un point de contact s'il détecte que l'utilisateur a commencé à déplacer la fenêtre.

Voir également keepTouchGrab() et setKeepMouseGrab().

void QQuickItem::setSize(const QSizeF &size)

Fixe la taille de l'élément à size. Cette méthode préserve tout lien existant sur la largeur et la hauteur ; ainsi, tout changement qui déclenche l'exécution du lien à nouveau remplacera les valeurs fixées.

Voir également size, setWidth, et setHeight.

QSizeF QQuickItem::size() const

Renvoie la taille de l'élément.

Voir aussi setSize, width, et height.

void QQuickItem::stackAfter(const QQuickItem *sibling)

Déplace cet élément à l'index suivant l'élément frère spécifié dans la liste des enfants. L'ordre des enfants affecte à la fois l'ordre d'empilement visuel et l'ordre de navigation dans les onglets.

En supposant que les valeurs z des deux éléments soient identiques, sibling sera rendu sous cet élément.

Si les deux éléments ont pour valeur activeFocusOnTab true , l'ordre de mise au point des onglets sera également modifié, sibling recevant la mise au point avant cet élément.

Le site sibling doit être un frère de cet élément, c'est-à-dire qu'il doit avoir le même site parent.

Voir également Concepts - Parent visuel dans Qt Quick.

void QQuickItem::stackBefore(const QQuickItem *sibling)

Déplace cet élément à l'index précédant l'élément frère spécifié dans la liste des enfants. L'ordre des enfants affecte à la fois l'ordre d'empilement visuel et l'ordre de navigation dans les onglets.

En supposant que les valeurs z des deux éléments soient identiques, sibling sera rendu au-dessus de cet élément.

Si les deux éléments ont pour valeur activeFocusOnTab true , l'ordre de mise en évidence des onglets sera également modifié, sibling étant mis en évidence après cet élément.

Le site sibling doit être un frère de cet élément, c'est-à-dire qu'il doit avoir le même site parent.

Voir également Concepts - Parent visuel dans Qt Quick.

[virtual] QSGTextureProvider *QQuickItem::textureProvider() const

Renvoie le fournisseur de texture d'un élément. L'implémentation par défaut renvoie nullptr.

Cette fonction ne peut être appelée que sur le thread de rendu.

[virtual protected] void QQuickItem::touchEvent(QTouchEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements tactiles d'un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

L'événement est accepté par défaut, il n'est donc pas nécessaire d'accepter explicitement l'événement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

[virtual protected] void QQuickItem::touchUngrabEvent()

Ce gestionnaire d'événement peut être réimplémenté dans une sous-classe afin d'être notifié lorsqu'un événement de désappropriation tactile s'est produit sur cet élément.

void QQuickItem::unsetCursor()

Efface la forme du curseur pour cet élément.

Voir aussi cursor() et setCursor().

[slot] void QQuickItem::update()

Planifie un appel à updatePaintNode() pour cet article.

L'appel à QQuickItem::updatePaintNode() aura toujours lieu si l'élément est affiché dans une page QQuickWindow.

Seuls les éléments qui spécifient QQuickItem::ItemHasContents sont autorisés à appeler QQuickItem::update().

[protected] void QQuickItem::updateInputMethod(Qt::InputMethodQueries queries = Qt::ImQueryInput)

Notifier à la méthode d'entrée les valeurs de requête mises à jour si nécessaire. queries indique les attributs modifiés.

[virtual protected] QSGNode *QQuickItem::updatePaintNode(QSGNode *oldNode, QQuickItem::UpdatePaintNodeData *updatePaintNodeData)

Appelée sur le thread de rendu lorsqu'il est temps de synchroniser l'état de l'élément avec le graphe de scène.

La fonction est appelée à la suite de QQuickItem::update(), si l'utilisateur a activé le drapeau QQuickItem::ItemHasContents sur l'élément.

La fonction doit renvoyer la racine du sous-arbre du graphe de scène pour cet élément. La plupart des implémentations renvoient un seul QSGGeometryNode contenant la représentation visuelle de cet élément. oldNode est le nœud qui a été renvoyé la dernière fois que la fonction a été appelée. updatePaintNodeData fournit un pointeur sur le QSGTransformNode associé à ce QQuickItem.

QSGNode *MyItem::updatePaintNode(QSGNode *node, UpdatePaintNodeData *)
{
    QSGSimpleRectNode *n = static_cast<QSGSimpleRectNode *>(node);
    if (!n) {
        n = new QSGSimpleRectNode();
        n->setColor(Qt::red);
    }
    n->setRect(boundingRect());
    return n;
}

Le thread principal est bloqué pendant l'exécution de cette fonction, de sorte qu'il n'y a aucun risque à lire les valeurs de l'instance QQuickItem et d'autres objets dans le thread principal.

Si aucun appel à QQuickItem::updatePaintNode() n'entraîne de modification du graphe de la scène, comme QSGNode::markDirty() ou l'ajout et la suppression de nœuds, l'implémentation sous-jacente peut décider de ne pas effectuer de nouveau rendu de la scène, car le résultat visuel est identique.

Voir aussi QSGMaterial, QSGGeometryNode, QSGGeometry, QSGFlatColorMaterial, QSGTextureMaterial, QSGNode::markDirty(), et Graphics Resource Handling.

[virtual protected] void QQuickItem::updatePolish()

Cette fonction doit effectuer toute mise en page nécessaire pour cet élément.

Lorsque polish() est appelé, le graphe de scène planifie un événement de polissage pour cet élément. Lorsque le graphe de scène est prêt à effectuer le rendu de cet élément, il appelle updatePolish() pour effectuer la mise en page de l'élément avant d'effectuer le rendu de l'image suivante.

Voir également ensurePolished().

QQuickItem *QQuickItem::viewportItem() const

Si l'indicateur ItemObservesViewport est activé, renvoie le parent le plus proche avec l'indicateur ItemIsViewport. Renvoie l'élément de contenu de la fenêtre si l'indicateur n'est pas activé ou si aucun autre élément de la fenêtre n'est trouvé.

Renvoie nullptr uniquement s'il n'y a pas d'élément dans la fenêtre et si cet élément n'est pas affiché dans une fenêtre.

Voir également clipRect().

[virtual protected] void QQuickItem::wheelEvent(QWheelEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe pour recevoir les événements de roue d'un élément. Les informations relatives à l'événement sont fournies par le paramètre event.

L'événement est accepté par défaut, il n'est donc pas nécessaire d'accepter explicitement l'événement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

[protected] bool QQuickItem::widthValid() const

Indique si la propriété width a été définie explicitement.

QQuickWindow *QQuickItem::window() const

Renvoie la fenêtre dans laquelle cet élément est rendu.

L'élément n'a pas de fenêtre tant qu'il n'a pas été affecté à une scène. Le signal windowChanged() permet de notifier à la fois l'entrée de l'élément dans une scène et son retrait d'une scène.

[signal] void QQuickItem::windowChanged(QQuickWindow *window)

Ce signal est émis lorsque l'adresse window de l'élément change.