QGraphicsLayout Class

Documentation des fonctions membres

QGraphicsLayout::QGraphicsLayout(QGraphicsLayoutItem *parent = nullptr)

Construit un objet QGraphicsLayout.

parent est transmis au constructeur de QGraphicsLayoutItem et l'argument isLayout de QGraphicsLayoutItem est fixé à true.

Si parent est un QGraphicsWidget, la disposition sera installée sur ce widget. (Notez que l'installation d'une disposition supprime l'ancienne disposition installée).

[virtual noexcept] QGraphicsLayout::~QGraphicsLayout()

Détruit l'objet QGraphicsLayout.

void QGraphicsLayout::activate()

Active la disposition, ce qui a pour effet de réorganiser immédiatement tous les éléments de la disposition. Cette fonction est basée sur l'appel de count() et itemAt(), puis sur l'appel de setGeometry() sur tous les éléments de manière séquentielle. Lorsqu'elle est activée, la disposition ajuste sa géométrie en fonction de la fonction contentsRect() de son parent. Le parent invalide alors toute disposition qu'il possède.

Si elle est appelée de manière séquentielle ou récursive, par exemple par l'un des éléments agencés en réponse à un redimensionnement, cette fonction ne fera rien.

Notez que la disposition est libre d'utiliser la mise en cache de la géométrie pour optimiser ce processus. Pour invalider de force un tel cache, vous pouvez appeler invalidate() avant d'appeler activate().

Voir aussi invalidate().

[protected] void QGraphicsLayout::addChildLayoutItem(QGraphicsLayoutItem *layoutItem)

Cette fonction est une fonction de commodité fournie pour les mises en page personnalisées. Elle passe en revue tous les éléments de la mise en page et reporte leurs éléments graphiques sur l'ancêtre QGraphicsWidget le plus proche de la mise en page.

Si layoutItem se trouve déjà dans une disposition différente, il sera supprimé de cette disposition.

Si des mises en page personnalisées souhaitent un comportement particulier, elles peuvent ignorer cette fonction et implémenter leur propre comportement.

Voir aussi graphicsItem().

[pure virtual] int QGraphicsLayout::count() const

Cette fonction virtuelle pure doit être réimplémentée dans une sous-classe de QGraphicsLayout afin de renvoyer le nombre d'éléments dans la présentation.

La sous-classe est libre de décider comment stocker les éléments.

Voir également itemAt() et removeAt().

[override virtual] void QGraphicsLayout::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const

Réimplémente : QGraphicsLayoutItem::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const.

[virtual] void QGraphicsLayout::invalidate()

Efface toutes les informations de géométrie et de taille mises en cache dans la disposition et envoie un événement LayoutRequest au parent géré QGraphicsLayoutItem.

Voir aussi activate() et setGeometry().

bool QGraphicsLayout::isActivated() const

Renvoie true si la disposition est en cours d'activation ; sinon, renvoie false. Si la disposition est activée, cela signifie qu'elle est en train de réorganiser ses éléments (c'est-à-dire que la fonction activate() a été appelée et n'a pas encore été renvoyée).

Voir également activate() et invalidate().

[pure virtual] QGraphicsLayoutItem *QGraphicsLayout::itemAt(int i) const

Cette fonction virtuelle pure doit être réimplémentée dans une sous-classe de QGraphicsLayout pour renvoyer un pointeur sur l'élément à l'index i. La réimplémentation peut supposer que i est valide (c'est-à-dire qu'elle respecte la valeur de count()). Avec count(), il est fourni comme moyen d'itérer sur tous les éléments d'une disposition.

La sous-classe est libre de décider comment stocker les éléments, et la disposition visuelle n'a pas à être reflétée par cette fonction.

Voir également count() et removeAt().

[pure virtual] void QGraphicsLayout::removeAt(int index)

Cette fonction virtuelle pure doit être réimplémentée dans une sous-classe de QGraphicsLayout pour supprimer l'élément à index. La réimplémentation peut supposer que index est valide (c'est-à-dire qu'elle respecte la valeur de count()).

L'implémentation doit s'assurer que le parentLayoutItem() de l'élément supprimé ne pointe pas vers cette disposition, puisque l'élément est considéré comme supprimé de la hiérarchie des dispositions.

Si la disposition doit être réutilisée par d'autres applications, nous recommandons que la disposition supprime l'élément, mais le cadre des vues graphiques n'en dépend pas.

La sous-classe est libre de décider comment stocker les éléments.

Voir également itemAt() et count().

void QGraphicsLayout::setContentsMargins(qreal left, qreal top, qreal right, qreal bottom)

Définit les marges de contenu à left, top, right et bottom. Les marges de contenu par défaut pour les mises en page de premier niveau dépendent du style (en interrogeant le pixelMetric pour QStyle::PM_LayoutLeftMargin, QStyle::PM_LayoutTopMargin, QStyle::PM_LayoutRightMargin et QStyle::PM_LayoutBottomMargin).

Pour les sous-mises en page, les marges par défaut sont de 0.

La modification des marges de contenu invalide automatiquement la présentation.

Voir aussi invalidate().

[override virtual] void QGraphicsLayout::updateGeometry()

Réimplémente : QGraphicsLayoutItem::updateGeometry().

[virtual] void QGraphicsLayout::widgetEvent(QEvent *e)

Ce gestionnaire d'événements virtuel reçoit tous les événements pour le widget géré. QGraphicsLayout utilise ce gestionnaire d'événements pour écouter les événements liés à la mise en page tels que les changements de géométrie, les changements de mise en page ou les changements de direction de la mise en page.

e est un pointeur sur l'événement.

Vous pouvez réimplémenter ce gestionnaire d'événements pour suivre des événements similaires pour votre propre mise en page.

Voir aussi QGraphicsWidget::event() et QGraphicsItem::sceneEvent().