QLayoutItem Class

Documentation des fonctions membres

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

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

[virtual noexcept] QLayoutItem::~QLayoutItem()

Supprime l'QLayoutItem.

Qt::Alignment QLayoutItem::alignment() const

Renvoie l'alignement de cet élément.

Voir aussi setAlignment().

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

Renvoie le ou les types de contrôle associés à 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 mise en page.

Voir également QSizePolicy::controlType().

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

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

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

Renvoie le rectangle délimité 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 mise en page 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 également 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 sa largeur, qui n'est pas prise en compte 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() sera généralement beaucoup plus rapide que d'appeler cette fonction et de vérifier si elle renvoie -1.

Réimplémentez cette fonction dans les gestionnaires de mise en page qui prennent en charge la hauteur en fonction de la largeur. Une implémentation type ressemblera à 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()

Annule toutes les informations mises en cache dans cet élément de mise en page.

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

Mise en œuvre 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 de type ` QLayout`, il est renvoyé sous la forme ` QLayout` ; dans le cas contraire, ` nullptr ` est renvoyé. Cette fonction assure une conversion de type sécurisée.

Voir également spacerItem() et widget().

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

À implémenter 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émenter 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 de ` QLayoutItem ` pour lesquelles il a un effet visuel. À l’exception de ` QSpacerItem`, qui fournit un espace vide pour les mises en page, toutes les classes Qt publiques héritant de ` QLayoutItem ` prennent en charge l’alignement des éléments.

Voir également alignment().

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

À implémenter dans les sous-classes pour définir la géométrie de cet élément sur r.

Voir également geometry().

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

À implémenter dans les sous-classes pour renvoyer la taille préférée de cet élément.

[virtual] QSpacerItem *QLayoutItem::spacerItem()

Si cet élément est de type ` QSpacerItem`, il est renvoyé sous la forme ` QSpacerItem` ; sinon, ` nullptr ` est renvoyé. Cette fonction assure une conversion de type sécurisée.

Voir également layout() et widget().

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

Si cet élément gère un QWidget, cette fonction renvoie ce widget. Sinon, elle renvoie nullptr.

Voir également layout() et spacerItem().