QLayoutItem Class

Documentation sur les fonctions membres

[explicit] QLayoutItem::QLayoutItem(Qt::Alignment alignment = Qt::Alignment())

Construit un élément de mise en page avec un alignment. Toutes les sous-classes ne prennent pas en charge l'alignement.

[virtual noexcept] QLayoutItem::~QLayoutItem()

Détruit le site QLayoutItem.

Qt::Alignment QLayoutItem::alignment() const

Renvoie l'alignement de cet élément.

Voir également setAlignment().

[virtual] QSizePolicy::ControlTypes QLayoutItem::controlTypes() const

Renvoie le(s) type(s) de contrôle pour l'élément de mise en page. Pour un QWidgetItem, le type de contrôle provient de la politique de taille du widget ; pour un QLayoutItem, le type de contrôle est dérivé du contenu de la disposition.

Voir également QSizePolicy::controlType().

[pure virtual] Qt::Orientations QLayoutItem::expandingDirections() const

Renvoie si cet élément de mise en page peut utiliser plus d'espace que sizeHint(). Une valeur de Qt::Vertical ou Qt::Horizontal signifie qu'il veut s'agrandir dans une seule dimension, tandis que Qt::Vertical | Qt::Horizontal signifie qu'il veut s'agrandir dans les deux dimensions.

[pure virtual] QRect QLayoutItem::geometry() const

Renvoie le rectangle couvert par cet élément de mise en page.

Voir également setGeometry().

[virtual] bool QLayoutItem::hasHeightForWidth() const

Renvoie true si la hauteur préférée de cette disposition dépend de sa largeur ; sinon, renvoie false. L'implémentation par défaut renvoie false.

Réimplémentez cette fonction dans les gestionnaires de mise en page qui prennent en charge la hauteur en fonction de la largeur.

Voir aussi heightForWidth() et QWidget::heightForWidth().

[virtual] int QLayoutItem::heightForWidth(int) const

Renvoie la hauteur préférée pour cet élément de mise en page, compte tenu de la largeur, qui n'est pas utilisée dans cette implémentation par défaut.

L'implémentation par défaut renvoie -1, ce qui indique que la hauteur préférée est indépendante de la largeur de l'élément. L'utilisation de la fonction hasHeightForWidth() est généralement beaucoup plus rapide que l'appel à cette fonction et le test de -1.

Réimplémentez cette fonction dans les gestionnaires de mise en page qui prennent en charge la hauteur pour la largeur. Une implémentation typique ressemble à ceci :

int MyLayout::heightForWidth(int w) const
{
    if (cache_dirty || cached_width != w) {
        MyLayout *that = const_cast<MyLayout *>(this);
        int h = calculateHeightForWidth(w);
        that->cached_hfw = h;
        return h;
    }
    return cached_hfw;
}

La mise en cache est fortement recommandée ; sans elle, la mise en page prendra un temps exponentiel.

Voir également hasHeightForWidth().

[virtual] void QLayoutItem::invalidate()

Invalide toute information mise en cache dans cet élément de mise en page.

[pure virtual] bool QLayoutItem::isEmpty() const

Implémenté dans les sous-classes pour indiquer si cet élément est vide, c'est-à-dire s'il contient des widgets.

[virtual] QLayout *QLayoutItem::layout()

Si cet élément est un QLayout, il est renvoyé sous la forme d'un QLayout; sinon, il est renvoyé sous la forme d'un nullptr. Cette fonction permet une distribution sûre des types.

Voir aussi spacerItem() et widget().

[pure virtual] QSize QLayoutItem::maximumSize() const

Implémenté dans les sous-classes pour renvoyer la taille maximale de cet élément.

[virtual] int QLayoutItem::minimumHeightForWidth(int w) const

Renvoie la hauteur minimale dont ce widget a besoin pour la largeur donnée, w. L'implémentation par défaut renvoie simplement heightForWidth(w).

[pure virtual] QSize QLayoutItem::minimumSize() const

Implémenté dans les sous-classes pour renvoyer la taille minimale de cet élément.

void QLayoutItem::setAlignment(Qt::Alignment alignment)

Définit l'alignement de cet élément sur alignment.

Remarque : l'alignement des éléments n'est pris en charge que par les sous-classes QLayoutItem lorsqu'il a un effet visuel. À l'exception de QSpacerItem, qui fournit un espace vide pour les mises en page, toutes les classes Qt XML publiques qui héritent de QLayoutItem prennent en charge l'alignement des éléments.

Voir aussi alignment().

[pure virtual] void QLayoutItem::setGeometry(const QRect &r)

Implémenté dans les sous-classes pour définir la géométrie de cet élément à r.

Voir aussi geometry().

[pure virtual] QSize QLayoutItem::sizeHint() const

Implémenté dans les sous-classes pour renvoyer la taille préférée de cet objet.

[virtual] QSpacerItem *QLayoutItem::spacerItem()

Si cet élément est un QSpacerItem, il est renvoyé sous la forme d'un QSpacerItem; sinon, il est renvoyé sous la forme d'un nullptr. Cette fonction permet une distribution sûre des types.

Voir aussi layout() et widget().

[virtual] QWidget *QLayoutItem::widget() const

Si cet élément gère un QWidget, il renvoie ce widget. Sinon, c'est nullptr qui est renvoyé.

Voir également layout() et spacerItem().