QQuickItem Class

Documentation sur les fonctions membres

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

Crée un objet `QQuickItem` à partir de l'parent` fourni.

L'parent sera utilisé à la fois comme parent de l'visual parent et de l'QObject.

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

Supprime l'QQuickItem.

bool QQuickItem::acceptHoverEvents() const

Indique si les événements de survol sont pris en charge 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 via les fonctions hoverEnterEvent(), hoverMoveEvent() et hoverLeaveEvent().

Voir également setAcceptHoverEvents().

bool QQuickItem::acceptTouchEvents() const

Indique si cet élément accepte les événements tactiles.

La valeur par défaut est « false ».

Si cette valeur est « false », l'élément ne recevra aucun événement tactile via la fonction touchEvent().

Voir également setAcceptTouchEvents().

Qt::MouseButtons QQuickItem::acceptedMouseButtons() const

Renvoie les boutons de souris pris en charge par cet élément.

La valeur par défaut est Qt::NoButton; cela signifie qu'aucun bouton de souris n'est pris en charge.

Si un élément n'accepte pas le bouton de souris pour un événement de souris particulier, cet événement ne sera pas transmis à cet élément, mais 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 limites 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.

Renvoie nullptr s'il n'existe aucun élément de ce type.

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

Renvoie les éléments 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 éléments enfants de cet élément.

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

Renvoyez ` true ` si l’événement spécifié ` event ` ne doit pas être transmis à l’enfant spécifié ` item`, et ` false ` dans le cas contraire. Si vous renvoyez ` true`, vous devez également ` accept ` ou ` ignore ` l’événement ` event`, afin d’indiquer si la propagation de l’événement doit s’arrêter ou se poursuivre. L’événement ` event ` sera toutefois toujours envoyé à tous les `childMouseEventFilters` en amont dans 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 à exécuter dans `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 d’affichage et que l’indicateur ` ItemObservesViewport ` est activé ; sinon, renvoie les limites 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 éléments graphiques ajoutés au graphe de scène.

Par exemple, un dessin de grande taille ou un document texte volumineux peut s’afficher dans un Flickable qui n’occupe qu’une partie de la fenêtre de l’application : dans ce cas, Flickable est l’élément de fenêtre d’affichage, 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 l’indicateur « ItemObservesViewport » est activé, cette zone changera à chaque fois que l’utilisateur fera défiler le contenu dans le Flickable.

Dans le cas d’éléments de fenêtre d’affichage imbriqués, clipRect() correspond à l’intersection des zones de découpe ( boundingRect) de tous les ancêtres pour lesquels l’indicateur « ItemIsViewport » est activé, reportée 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 lors de l'événement `componentComplete`.

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

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

Cette fonction peut être redéfinie 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 du cadre de délimitation dans le cas contraire.

QCursor QQuickItem::cursor() const

Renvoie la forme du curseur correspondant à cet élément.

Le curseur de la souris prendra cette forme lorsqu’il se trouvera au-dessus de cet élément, à moins qu’un curseur de remplacement ne soit défini. Consultez la page list of predefined cursor objects pour découvrir toute une gamme de formes utiles.

Si aucune forme de curseur n'a été définie, cette fonction renvoie un curseur dont la forme correspond à celle de l'Qt::ArrowCursor; toutefois, une autre forme de curseur peut s'afficher si un élément qui se superpose à celui-ci dispose d'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 afin de recevoir les événements « drag-enter » pour 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 disponibles 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 « Glisser-déposer ».

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

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe afin de recevoir les événements « drag-leave » pour 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 disponibles 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 « Glisser-déposer ».

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

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe afin de recevoir les événements de glisser-déplacer pour 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 « Glisser-déposer ».

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

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe afin de recevoir les événements de dépôt 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 « Glisser-déposer ».

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

Affiche certaines informations concernant l'arborescence visuelle des éléments à partir de cet élément, de manière récursive.

Cette fonction a été introduite dans Qt 6.3.

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

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

Appelle la méthode updatePolish()

Cela peut s'avérer utile pour des éléments tels que les Layouts (ou les 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’une mise en page, la taille implicite n’est pas calculée immédiatement (il s’agit d’une optimisation). Dans certains cas, il peut être souhaitable d'interroger la taille implicite de la mise en page immédiatement après l'ajout d'un élément enfant. Si tel est le cas, utilisez cette fonction juste avant d'interroger 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 éléments enfants de cet élément doivent être filtrés par cet élément.

Si cet élément et un de ses enfants ont tous deux défini acceptTouchEvents() true, alors lorsqu’une interaction tactile se produit, cet élément filtrera l’événement tactile. Mais si cet élément ou son 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 indicateurs associés à cet élément.

Voir également setFlags() et setFlag().

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

Ce gestionnaire d'événement peut être réimplémenté dans une sous-classe afin de recevoir les événements « focus-in » 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 de l'accepter explicitement 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 parente.

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

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe afin de recevoir les événements de perte de focus 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 de l'accepter explicitement si vous réimplémentez cette fonction. Si vous n'acceptez pas l'événement, appelez event->ignore().

[invokable] void QQuickItem::forceActiveFocus()

Met l'élément au premier plan.

Cette méthode place le focus sur l’élément et garantit que tous les objets ancêtres de type « 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)

Permet de placer le focus sur l'élément dont l'reason est spécifiée.

Cette méthode place le focus sur l’élément et garantit que tous les objets ancêtres de type « FocusScope » dans la hiérarchie des objets reçoivent également l’attribut « 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 modifications de la 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 parente dans leur implémentation.

Cette fonction a été introduite dans Qt 6.0.

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

Récupère l'élément dans une image en mémoire.

La capture s'effectue de manière asynchrone et le signal QQuickItemGrabResult::ready() est émis une fois la capture 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 capture 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 afin de recevoir les événements « hover-enter » pour 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 défini sur true.

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 afin de recevoir les événements « hover » et « leave » pour 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 défini sur true.

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 afin de recevoir les événements « hover-move » 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() vaut true.

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 telle qu'elle est déterminée par d'autres propriétés qui définissent son contenu.

Voir aussi setImplicitWidth().

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

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe afin de recevoir les événements liés à la méthode de saisie 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 de l'accepter explicitement 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 s'applique qu'aux éléments de saisie.

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

Voir aussi 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 également parentItem().

[protected] bool QQuickItem::isComponentComplete() const

Renvoie « true » si la construction du composant QML est terminée ; sinon, renvoie « false ».

Il est souvent souhaitable de différer certaines opérations jusqu’à ce que le composant soit entièrement chargé.

Voir également ` componentComplete()`.

bool QQuickItem::isFocusScope() const

Renvoie « true » si cet élément est une lunette de visée, et « false » dans le cas contraire.

[virtual] bool QQuickItem::isTextureProvider() const

Renvoie « true » si cet élément est un fournisseur de textures. 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ée lorsqu'un événement « 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, veillez à appeler

QQuickItem::itemChange(change, value);

généralement à la fin de votre implémentation, afin de garantir que le signal ` windowChanged()` sera émis.

bool QQuickItem::keepMouseGrab() const

Indique si les événements de souris doivent être exclusivement attribués à cet élément.

Voir également setKeepMouseGrab(), QEvent::accept() et QEvent::ignore().

bool QQuickItem::keepTouchGrab() const

Indique si les points de contact capturés par cet élément doivent rester exclusivement associés à celui-ci.

Voir également 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 afin de recevoir les événements de frappe associés à 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 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::keyReleaseEvent(QKeyEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe afin de recevoir les événements de relâchement de 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 de l'accepter explicitement 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

Associe l'point e donnée dans le système de coordonnées global de l'écran au point équivalent dans le système de coordonnées de cet élément, puis renvoie la coordonnée associée.

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

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

Cela peut par exemple s’avérer utile pour ajouter une fenêtre contextuelle à un composant Qt Quick.

Voir également Concepts - Coordonnées visuelles sur Qt Quick.

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

Mappe l'point on fournie dans le système de coordonnées de item vers le point équivalent dans le système de coordonnées de cet élément, puis renvoie la coordonnée mappée.

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

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

Si ` item ` est ` nullptr`, cela effectue le mappage de ` point ` à partir du système de coordonnées de la scène.

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

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

Associe les coordonnées point données dans le système de coordonnées de la scène au point équivalent dans le système de coordonnées de cet élément, puis renvoie la coordonnée associée.

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

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

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

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

Mappe l'rect on fournie dans le système de coordonnées de item vers la zone rectangulaire équivalente dans le système de coordonnées de cet élément, puis renvoie la valeur du rectangle ainsi mappé.

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 mise en correspondance inclut la position relative des deux scènes.

Si ` item ` est ` nullptr`, cela effectue une projection de ` rect ` à partir du système de coordonnées de la scène.

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

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

Mappe les coordonnées rect données dans le système de coordonnées de la scène vers la zone rectangulaire équivalente dans le système de coordonnées de cet élément, puis renvoie la valeur du rectangle obtenu.

Les propriétés suivantes de l’élément sont utilisées pour 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 également Concepts - Coordonnées visuelles sur Qt Quick.

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

Mappe l'rect donné dans le système de coordonnées de cet élément vers la zone rectangulaire équivalente dans le système de coordonnées de item, puis renvoie la valeur du rectangle obtenu.

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

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

Si item vaut nullptr, cela mappe rect au système de coordonnées de la scène.

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

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

Associe l'rect e spécifiée dans le système de coordonnées de cet élément à la zone rectangulaire équivalente dans le système de coordonnées de la scène, puis renvoie la valeur du rectangle associé.

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, le mappage inclut la position relative des deux scènes.

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

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

Converte les coordonnées point fournies dans le système de coordonnées de cet élément en un point équivalent dans le système de coordonnées global de l'écran, puis renvoie la coordonnée convertie.

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

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

Cela peut par exemple s’avérer utile pour ajouter une fenêtre contextuelle à un composant Qt Quick.

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

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

Associe l'point e spécifiée dans le système de coordonnées de cet élément au point équivalent dans le système de coordonnées de item, puis renvoie la coordonnée associée.

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

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

Si « item » vaut « nullptr », cela mappe « point » vers le système de coordonnées de la scène.

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

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

Associe les coordonnées point fournies dans le système de coordonnées de cet élément au point équivalent dans le système de coordonnées de la scène, puis renvoie la coordonnée associée.

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

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

Voir également «Concepts - Coordonnées visuelles » sur Qt Quick.

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

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe afin de recevoir les événements de double-clic de 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 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::mouseMoveEvent(QMouseEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe afin de 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 de clic précédent doit être accepté (en redéfinissant mousePressEvent(), par exemple) et acceptedMouseButtons() doit renvoyer le bouton de souris concerné.

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 afin de recevoir les événements de clic de souris pour un élément. Les informations relatives à l'événement sont fournies par le paramètre ` event `.

Pour recevoir les événements de clic de souris, la fonction acceptedMouseButtons() doit renvoyer le bouton de souris concerné.

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::mouseReleaseEvent(QMouseEvent *event)

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe afin de 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 les événements de relâchement de la souris, l’événement de pression de souris précédent doit être accepté (en redéfinissant mousePressEvent(), par exemple) et acceptedMouseButtons() doit renvoyer le bouton de souris concerné.

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

Cet événement peut être réimplémenté dans une sous-classe afin d'être averti lorsqu'un événement de relâchement de la souris se produit sur cet élément.

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

Renvoie l'élément de la chaîne de focus situé à côté de cet élément. Si forward vaut true ou n'est pas fourni, il s'agit de l'élément suivant dans le sens avant. Si forward vaut false, il s'agit de l'élément suivant dans le sens arrière.

void QQuickItem::polish()

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

Lorsque le graphe de scène traite la requête, il appelle la méthode updatePolish() sur cet élément.

Voir également 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 encore gérées par les nœuds renvoyés par la fonction ` QQuickItem::updatePaintNode()`.

Cela se produit lorsque l’élément est sur le point d’être retiré de la fenêtre dans laquelle il s’affichait auparavant. Il est garanti que l’élément dispose d’un ` window ` lorsque la fonction est appelée.

La fonction est appelée sur le thread de l'interface graphique et l'état du thread de rendu, lorsqu'il est utilisé, est inconnu. Les objets ne doivent pas être supprimés directement, mais leur nettoyage doit être planifié à l'aide de QQuickWindow::scheduleRenderJob().

Voir également ` Graphics Resource Handling`.

QQuickItem *QQuickItem::scopedFocusItem() const

Si cet élément est un « focus scope », cette méthode renvoie l'élément de sa chaîne de focus qui détient actuellement le focus.

Renvoie « nullptr » si cet élément n'est pas une portée de focus.

void QQuickItem::setAcceptHoverEvents(bool enabled)

Si la propriété « enabled » est définie sur « true », cet élément accepte les événements de survol ; dans le cas contraire, il ne les accepte pas.

Voir également acceptHoverEvents().

void QQuickItem::setAcceptTouchEvents(bool enabled)

Si enabled est vrai, cette propriété configure l'élément pour qu'il accepte les événements tactiles ; dans le cas contraire, cet élément n'accepte pas les événements tactiles.

Voir également acceptTouchEvents().

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

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

Voir également acceptedMouseButtons().

void QQuickItem::setCursor(const QCursor &cursor)

Définit la forme « cursor » pour cet élément.

Voir également cursor() et unsetCursor().

void QQuickItem::setFiltersChildMouseEvents(bool filter)

Détermine si les événements de pointeur destinés aux éléments enfants de cet élément doivent être filtrés par celui-ci.

Si ` filter ` est défini à `true`, la méthode ` childMouseEventFilter()` sera appelée 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'flag spécifiée pour cet élément si la valeur de « enabled » est « true » ; si la valeur de « enabled » est « false », l'indicateur est désactivé.

Ces options fournissent diverses indications concernant l’élément ; par exemple, l’indicateur « ItemClipsChildrenToShape » indique que tous les éléments enfants de cet élément doivent être recadrés pour s’adapter à la zone de l’élément.

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

Active l'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 premier plan de cet élément sur « policy ».

Voir également focusPolicy().

void QQuickItem::setKeepMouseGrab(bool keep)

Détermine si l'entrée de la souris doit rester exclusivement associée à cet élément.

Cette option est utile pour les éléments qui souhaitent capturer et conserver l’interaction de la souris à la suite d’un geste prédéfini. Par exemple, un élément intéressé par le déplacement horizontal de la souris peut définir « keepMouseGrab » sur « true » dès qu’un seuil a été dépassé. Une fois « keepMouseGrab » défini sur « true », les éléments filtrants ne réagiront plus aux événements de la souris.

Si keep est défini sur false, un élément filtrant peut « voler » la capture. Par exemple, Flickable peut tenter de « voler » une capture de la souris s’il détecte que l’utilisateur a commencé à déplacer la fenêtre d’affichage.

Voir également keepMouseGrab().

void QQuickItem::setKeepTouchGrab(bool keep)

Détermine si les points de contact capturés par cet élément doivent rester exclusivement associés à celui-ci.

Cette option est utile pour les éléments qui souhaitent capturer et conserver des points de contact spécifiques à la suite d’un geste prédéfini. Par exemple, un élément intéressé par le déplacement horizontal des points de contact peut définir setKeepTouchGrab sur true dès qu’un seuil a été dépassé. Une fois setKeepTouchGrab défini sur true, les éléments de filtrage ne réagiront plus aux points de contact concernés.

Si ` keep ` est à `false`, un élément de filtrage peut « voler » la sélection. Par exemple, ` Flickable ` peut tenter de « voler » la sélection d’un point de contact s’il détecte que l’utilisateur a commencé à déplacer la fenêtre d’affichage.

Voir également keepTouchGrab() et setKeepMouseGrab().

void QQuickItem::setSize(const QSizeF &size)

Définit la taille de l'élément sur size. Cette méthode conserve toute liaison existante sur la largeur et la hauteur ; par conséquent, toute modification déclenchant une nouvelle exécution de la liaison remplacera les valeurs définies.

Voir également size, setWidth et setHeight.

QSizeF QQuickItem::size() const

Renvoie la taille de l'élément.

Voir également setSize, width et height.

void QQuickItem::stackAfter(const QQuickItem *sibling)

Déplace cet élément vers la position suivant l'élément frère spécifié dans la liste des enfants. L'ordre des enfants influe à la fois sur l'ordre d'empilement visuel et sur l'ordre de navigation par tabulation.

En supposant que les valeurs z des deux éléments soient identiques, cela entraînera l'affichage de « sibling » sous cet élément.

Si les deux éléments ont la propriété « activeFocusOnTab » définie sur « true », cela entraînera également une modification de l’ordre de navigation par tabulation, « sibling » recevant le focus avant cet élément.

L’élément « sibling » indiqué doit être un élément frère de cet élément ; c’est-à-dire qu’ils doivent avoir le même « parent » immédiat.

Voir également Concepts - Parent visuel dans Qt Quick.

void QQuickItem::stackBefore(const QQuickItem *sibling)

Déplace cet élément vers l'index situé avant l'élément frère spécifié dans la liste des enfants. L'ordre des enfants influe à la fois sur l'ordre d'empilement visuel et sur l'ordre de navigation par tabulation.

En supposant que les valeurs z des deux éléments soient identiques, cela entraînera l'affichage de « sibling » au-dessus de cet élément.

Si les deux éléments ont l’attribut « ` activeFocusOnTab ` » défini sur « ` true` », cela entraînera également une modification de l’ordre de navigation du focus du tab, « sibling » recevant alors le focus après cet élément.

L’élément « sibling » indiqué doit être un élément frère de cet élément ; c’est-à-dire qu’ils doivent avoir le même « parent » immédiat.

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 afin de recevoir les événements tactiles liés à 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 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::touchUngrabEvent()

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe afin d'être averti lorsqu'un événement « touch ungrab » se produit sur cet élément.

void QQuickItem::unsetCursor()

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

Voir également cursor() et setCursor().

[slot] void QQuickItem::update()

Planifie un appel à la fonction ` updatePaintNode()` pour cet élément.

L'appel à QQuickItem::updatePaintNode() aura toujours lieu si l'élément est affiché dans une 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)

Si nécessaire, informez la méthode de saisie de la mise à jour des valeurs de la requête. Le paramètre « 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.

Cette fonction est appelée à la suite de l'appel 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 correspondant à cet élément. La plupart des implémentations renverront un seul objet ` QSGGeometryNode ` contenant la représentation visuelle de cet élément. ` oldNode ` est le nœud qui a été renvoyé lors du dernier appel de la fonction. ` updatePaintNodeData ` fournit un pointeur vers l'objet ` QSGTransformNode ` associé à cet ` 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 ; il est donc possible de lire en toute sécurité les valeurs de l’instance QQuickItem et d’autres objets dans le thread principal.

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

Voir également 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 la fonction polish() est appelée, le graphe de scène planifie un événement « polish » pour cet élément. Lorsque le graphe de scène est prêt à afficher cet élément, il appelle la fonction updatePolish() afin d’effectuer la mise en page de l’élément selon les besoins avant d’afficher l’image suivante.

Voir également ensurePolished().

QQuickItem *QQuickItem::viewportItem() const

Si l'indicateur « ItemObservesViewport » est activé, renvoie le parent le plus proche pour lequel l'indicateur « ItemIsViewport » est activé. Renvoie le « contentItem » de la fenêtre si cet indicateur n'est pas activé, ou si aucun autre élément de la fenêtre d'affichage n'est trouvé.

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

Voir aussi clipRect().

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

Ce gestionnaire d'événements peut être réimplémenté dans une sous-classe afin de recevoir les événements de molette 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 de l'accepter explicitement 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 affiché.

L'élément ne dispose pas de fenêtre tant qu'il n'a pas été affecté à une scène. Le signal ` windowChanged()` envoie une notification à la fois lorsque l'élément est ajouté à une scène et lorsqu'il en est retiré.

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

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