QGraphicsGridLayout

La classe QGraphicsGridLayout fournit une disposition en grille pour la gestion des widgets dans une vue graphique. Plus d'informations...

#include <QGraphicsGridLayout>

Voir la position dans l'arbre des classes.

Héritage

Hérite de QGraphicsLayout.

Cette classe a été introduite dans Qt 4.4.

Description détaillée

La classe QGraphicsGridLayout fournit une disposition en grille pour la gestion des widgets dans une vue graphique.

La manière la plus commune d'utiliser QGraphicsGridLayout est de construire un objet sur le tas, sans parent, ajouter des widgets et des layouts en appelant addItem() et enfin assigner le layout à un widget en appelant QGraphicsWidget::setLayout(). QGraphicsGridLayout calcule automatiquement les dimensions de la grille en fonction des éléments ajoutés.

 QGraphicsScene scene;
 QGraphicsWidget *textEdit = scene.addWidget(new QTextEdit);
 QGraphicsWidget *pushButton = scene.addWidget(new QPushButton);
 
 QGraphicsGridLayout *layout = new QGraphicsGridLayout;
 layout->addItem(textEdit, 0, 0);
 layout->addItem(pushButton, 0, 1);
 
 QGraphicsWidget *form = new QGraphicsWidget;
 form->setLayout(layout);
 scene.addItem(form);

Le layout prend possession des éléments. Dans certains cas, lorsque l'élément du layout hérite également de QGraphicsItem (comme QGraphicsWidget), il y aura une ambiguïté dans la possession, car l'élément du layout appartient à deux hiérarchies. Consultez la documentation de QGraphicsLayoutItem::setOwnedByLayout() sur la manière de gérer cela. Vous pouvez accéder à chaque élément dans le layout en appelant count() et itemAt(). Appeler removeAt() enlèvera l'élément du layout sans le détruire.

Dimensions recommandées et politiques de redimensionnement dans QGraphicsGridLayout

QGraphicsGridLayout respecte les dimensions recommandées ainsi que la politique de redimensionnement de chaque élément et, lorsqu'une cellule de la grille a plus d'espace que ce que les éléments peuvent remplir, chaque élément est agencé en fonction de l'alignement du layout pour ce dernier. Vous pouvez préciser un alignement pour chaque élément en appelant setAlignment() et vérifier l'alignement de n'importe quel élément en appelant alignment(). Vous pouvez également préciser l'alignement pour une ligne ou une colonne entière en appelant respectivement setRowAlignment() et setColumnAlignment(). Par défaut, les éléments sont alignés dans le coin haut à gauche.

Voir aussi QGraphicsLinearLayout et QGraphicsWidget.

Fonctions membres

QGraphicsGridLayout::QGraphicsGridLayout ( QGraphicsLayoutItem * parent = 0 )

Construit une instance de QGraphicsGridLayout. parent est passé au constructeur de QGraphicsLayout.

QGraphicsGridLayout::~QGraphicsGridLayout () [virtual]

Détruit l'objet de QGraphicsGridLayout.

void QGraphicsGridLayout::addItem ( QGraphicsLayoutItem * item, int row, int column, int rowSpan, int columnSpan, Qt::Alignment alignment = 0 )

Ajoute item à la grille sur la ligne row et la colonne column. Vous pouvez spécifier une largeur de ligne rowSpan et de colonne columnSpan ainsi qu'un alignement alignment optionnel.

void QGraphicsGridLayout::addItem ( QGraphicsLayoutItem * item, int row, int column, Qt::Alignment alignment = 0 )

Ajoute item à la grille sur la ligne row et la colonne column. Vous pouvez spécifier un alignement alignment optionnel pour item.

Qt::Alignment QGraphicsGridLayout::alignment ( QGraphicsLayoutItem * item ) const

Retourne l'alignement de l'élément item.

Voir aussi setAlignment().

Qt::Alignment QGraphicsGridLayout::columnAlignment ( int column ) const

Retourne l'alignement pour la colonne column.

Voir aussi setColumnAlignment().

int QGraphicsGridLayout::columnCount () const

Retourne le nombre de colonnes dans la grille de disposition. Il y en a toujours une de plus que l'indice de la dernière colonne qui est occupée par un élément du layout (les colonnes vides sont comptées à l'exception de celles placées à la fin).

qreal QGraphicsGridLayout::columnMaximumWidth ( int column ) const

Retourne la taille largeur maximale de la colonne column.

Voir aussi setColumnMaximumWidth().

qreal QGraphicsGridLayout::columnMinimumWidth ( int column ) const

Retourne la taille largeur minimale de la colonne column.

Voir aussi setColumnMinimumWidth().

qreal QGraphicsGridLayout::columnPreferredWidth ( int column ) const

Retourne la largeur à privilégier pour la colonne column.

Voir aussi setColumnPreferredWidth().

qreal QGraphicsGridLayout::columnSpacing ( int column ) const

Retourne l'espacement entre colonnes pour la colonne column.

Voir aussi setColumnSpacing().

int QGraphicsGridLayout::columnStretchFactor ( int column ) const

Retourne le facteur d'étirement pour la colonne column.

Voir aussi setColumnStretchFactor().

int QGraphicsGridLayout::count () const [virtual]

Redéfinition de QGraphicsLayout::count().

Retourne le nombre d'éléments du layout dans cette grille de disposition.

qreal QGraphicsGridLayout::horizontalSpacing () const

Retourne l'espace horizontal par défaut pour cette grille de disposition.

Voir aussi setHorizontalSpacing().

void QGraphicsGridLayout::invalidate () [virtual]

Redéfinition de QGraphicsLayout::invalidate().

QGraphicsLayoutItem * QGraphicsGridLayout::itemAt ( int row, int column ) const

Retourne un pointeur sur l'élément du layout à (row, column).

QGraphicsLayoutItem * QGraphicsGridLayout::itemAt ( int index ) const [virtual]

Redéfinition de QGraphicsLayout::itemAt().

Retourne l'élément du layout à index ou 0 s'il n'y a pas d'élément du layout à cet indice.

void QGraphicsGridLayout::removeAt ( int index ) [virtual]

Redéfinition de QGraphicsLayout::removeAt().

Retire l'élément du layout à index sans le détruire. La possession de cet élément est transférée à l'appelant.

Voir aussi addItem().

Qt::Alignment QGraphicsGridLayout::rowAlignment ( int row ) const

Retourne l'alignement de la ligne row.

Voir aussi setRowAlignment().

int QGraphicsGridLayout::rowCount () const

Retourne le nombre de lignes du layout en grille. Il s'agit toujours d'une unité de plus que l'indice de la dernière ligne qui est occupée par un élément du layout (les lignes vides sont comptées excepté celles placées à la fin).

qreal QGraphicsGridLayout::rowMaximumHeight ( int row ) const

Retourne la hauteur maximale de la ligne row.

Voir aussi setRowMaximumHeight().

qreal QGraphicsGridLayout::rowMinimumHeight ( int row ) const

Retourne la hauteur minimale de la ligne row.

Voir aussi setRowMinimumHeight().

qreal QGraphicsGridLayout::rowPreferredHeight ( int row ) const

Retourne la hauteur privilégiée pour la ligne row.

Voir aussi setRowPreferredHeight().

qreal QGraphicsGridLayout::rowSpacing ( int row ) const

Retourne l'espacement entre les lignes pour la ligne row.

Voir aussi setRowSpacing().

int QGraphicsGridLayout::rowStretchFactor ( int row ) const

Retourne le facteur d'étirement pour la ligne row.

Voir aussi setRowStretchFactor().

void QGraphicsGridLayout::setAlignment ( QGraphicsLayoutItem * item, Qt::Alignment alignment )

Positionne l'alignement pour l'élément item à alignment.

Voir aussi alignment().

void QGraphicsGridLayout::setColumnAlignment ( int column, Qt::Alignment alignment )

Positionne l'alignement pour la colonne column à alignment.

Voir aussi columnAlignment().

void QGraphicsGridLayout::setColumnFixedWidth ( int column, qreal width )

Définit la largeur fixe de la colonne column à width.

void QGraphicsGridLayout::setColumnMaximumWidth ( int column, qreal width )

Définit la largeur maximale de la colonne column à width.

Voir aussi columnMaximumWidth().

void QGraphicsGridLayout::setColumnMinimumWidth ( int column, qreal width )

Définit la largeur minimale de la colonne column à width.

Voir aussi columnMinimumWidth().

void QGraphicsGridLayout::setColumnPreferredWidth ( int column, qreal width )

Définit la largeur privilégiée de la colonne column à width.

Voir aussi columnPreferredWidth().

void QGraphicsGridLayout::setColumnSpacing ( int column, qreal spacing )

Définit l'espacement de la colonne column à spacing.

Voir aussi columnSpacing().

void QGraphicsGridLayout::setColumnStretchFactor ( int column, int stretch )

Définit le facteur d'étirement de la colonne column à stretch.

Voir aussi columnStretchFactor().

void QGraphicsGridLayout::setGeometry ( const QRectF & rect ) [virtual]

Redéfinition de QGraphicsLayoutItem::setGeometry().

Définit les contours géométriques du layout en grille à rect.

void QGraphicsGridLayout::setHorizontalSpacing ( qreal spacing )

Définit l'espacement horizontal par défaut pour la grille du layout à spacing.

Voir aussi horizontalSpacing().

void QGraphicsGridLayout::setRowAlignment ( int row, Qt::Alignment alignment )

Positionne l'alignement de la ligne row à alignment.

Voir aussi rowAlignment().

void QGraphicsGridLayout::setRowFixedHeight ( int row, qreal height )

Positionne la hauteur fixe de la ligne row à height.

void QGraphicsGridLayout::setRowMaximumHeight ( int row, qreal height )

Positionne la hauteur maximale de la ligne row à height.

Voir aussi rowMaximumHeight().

void QGraphicsGridLayout::setRowMinimumHeight ( int row, qreal height )

Positionne la hauteur minimale de la ligne row à height.

Voir aussi rowMinimumHeight().

void QGraphicsGridLayout::setRowPreferredHeight ( int row, qreal height )

Positionne la hauteur privilégiée de la ligne row à height.

Voir aussi rowPreferredHeight().

void QGraphicsGridLayout::setRowSpacing ( int row, qreal spacing )

Positionne l'espacement de la ligne row à spacing.

Voir aussi rowSpacing().

void QGraphicsGridLayout::setRowStretchFactor ( int row, int stretch )

Positionne le facteur d'étirement de la ligne row à stretch.

Voir aussi rowStretchFactor().

void QGraphicsGridLayout::setSpacing ( qreal spacing )

Définit l'espacement vertical et horizontal par défaut du layout en grille à spacing.

Voir aussi rowSpacing() et columnSpacing().

void QGraphicsGridLayout::setVerticalSpacing ( qreal spacing )

Définit l'espacement vertical par défaut du layout en grille à spacing.

Voir aussi verticalSpacing().

QSizeF QGraphicsGridLayout::sizeHint ( Qt::SizeHint which, const QSizeF & constraint = QSizeF() ) const [virtual]

Redéfinition de QGraphicsLayoutItem::sizeHint().

qreal QGraphicsGridLayout::verticalSpacing () const

Retourne l'espacement vertical par défaut du layout en grille.

Voir aussi setVerticalSpacing().

Remerciements

Merci à Dimitry Ernot pour la traduction, ainsi qu'à Jonathan Courtois, Thibaut Cuvelier et Claude Leloup pour leur relecture !