QDialogButtonBox

La classe QDialogButtonBox représente un widget qui affiche un bouton dans une disposition adaptée au style actuel du widget. Plus d'informations...

 #include <QDialogButtonBox>

Héritage

Hérite de QWidget.

Cette classe a été introduite dans Qt 4.2.

Description détaillée

La classe QDialogButtonBox représente un widget qui affiche un bouton dans une disposition adaptée au style actuel du widget.

Les boîtes de dialogue et les boîtes de message affichent typiquement des boutons dans une disposition conforme aux directives de la plate-forme. Invariablement, différentes plates-formes possèdent différentes dispositions pour leurs boîtes de dialogue. QDialogButtonBox permet aux développeurs d'ajouter des boutons à celles-ci et utilisera automatiquement la disposition appropriée à l'environnement de l'utilisateur.

La plupart des boutons pour les boîtes de dialogue respectent certains rôles. Ces rôles sont :

• acceptation ou rejet de la boîte de dialogue ;
• demande d'aide ;
• exécution d'actions sur la boîte de dialogue elle-même (telles que la réinitialisation des champs ou l'application de changements).

Il peut y avoir d'autres méthodes pour écarter la boîte de dialogue qui peuvent mener à des résultats destructifs.

La plupart des boîtes de dialogue possèdent des boutons qui peuvent être considérés comme standard (par exemple : les boutons OK et Annuler). Il est quelquefois utile de créer ces boutons de manière standard.

Il y a deux méthodes pour utiliser QDialogButtonBox. L'une d'elles est de créer les boutons (ou les boutons textuels) vous-même et de les ajouter dans la boîte de boutons, en spécifiant leurs rôles.

     findButton = new QPushButton(tr("&Find"));
     findButton->setDefault(true);
 
     moreButton = new QPushButton(tr("&More"));
     moreButton->setCheckable(true);
     moreButton->setAutoDefault(false);
 
     buttonBox = new QDialogButtonBox(Qt::Vertical);
     buttonBox->addButton(findButton, QDialogButtonBox::ActionRole);
     buttonBox->addButton(moreButton, QDialogButtonBox::ActionRole);

Autrement, QDialogButtonBox fournit plusieurs boutons standard (par exemple, OK, Annuler, Sauvegarder) que vous pouvez utiliser. Ils sont définis en tant qu'indicateurs, vous pouvez donc les assembler avec l'opérateur OU logique dans le constructeur.

     buttonBox = new QDialogButtonBox(QDialogButtonBox::Ok
                                      | QDialogButtonBox::Cancel);
 
     connect(buttonBox, SIGNAL(accepted()), this, SLOT(accept()));
     connect(buttonBox, SIGNAL(rejected()), this, SLOT(reject()));

Vous pouvez utiliser des boutons normaux et des boutons standard en même temps.

Actuellement les boutons sont disposés de la manière suivante si la boîte de boutons est horizontale :

	Boîte de boutons horizontale GnomeLayout
	Boîte de boutons horizontale KdeLayout
	Boîte de boutons horizontale MacLayout
	Boîte de boutons horizontale WinLayout

Les boutons sont disposés de la manière suivante si la boîte de boutons est verticale:

GnomeLayout	KdeLayout	MacLayout	WinLayout

De plus, les boîtes de boutons qui ne contiennent que des boutons avec les rôles ActionRole ou HelpRole peuvent être considérées comme étant non modales et avoir une apparence différente sur Mac OS X:

MacLayout non-modal horizontal

Lorsqu'un bouton est cliqué dans la boîte de boutons, le signal clicked() est émis pour le bouton actuel qui est appuyé. Pour plus de facilité, si un bouton a un AcceptRole, RejectRole ou HelpRole, les signaux accepted(), rejected() ou helpRequested() sont émis respectivement.

Si vous souhaitez avoir un bouton sélectionné par défaut, vous devez appeler la fonction QPushButton::setDefault() sur ce bouton. Par contre, s'il n'y a aucun bouton par défaut de défini et afin de s'assurer que le même bouton soit sélectionné par défaut sur toutes les plates-formes lors de l'utilisation de la propriété QPushButton::autoDefault, le premier bouton avec un rôle d'acceptation sera le bouton par défaut lorsque la QDialogButtonBox est affichée.

Voir aussi QMessageBox, QPushButton et QDialog.

Type

enum QDialogButtonBox::ButtonLayout

Cette énumération décrit la politique de mise en page à utiliser lors de l'arrangement des boutons contenus dans la boîte de boutons.

La mise en page du layout est spécifiée par le style courant. Toutefois, sur les plates-formes X11, il peut être influencé par le gestionnaire de fenêtres.

enum QDialogButtonBox::ButtonRole

Cette énumération décrit le rôle des boutons dans la boîte de boutons. La combinaison de ces rôles permet de décrire des comportements différents.

Voir aussi StandardButton.

enum QDialogButtonBox::StandardButtonflags QDialogButtonBox::StandardButtons

Cette énumération décrit des indicateurs pour les boutons standard. Chaque bouton à un rôle ButtonRole de défini.

Le type StandardButtons est un typedef pour QFlags<StandardButton>. Il contient une combinaison de valeurs StandardButton pouvant être assemblées avec un OU logique.

Voir aussi ButtonRole et standardButtons.

Propriétés

centerButtons : bool

Cette propriété indique si les boutons de la boîte de boutons sont centrés.

Par défaut, la propriété est définie à false. Ce comportement est approprié pour la plupart des types de boîtes de dialogue. Des exceptions notables sont les boîtes de message sur la plupart des plates-formes (par exemple, Windows), où la boîte de boutons est centrée horizontalement.

Fonction d'accès

bool centerButtons () const

void setCenterButtons ( bool center )

Voir aussi QMessageBox.

orientation : Qt::Orientation

Cette propriété indique l'orientation de la boîte de boutons.

Par défaut, l'orientation est horizontale (c'est-à-dire que les boutons sont alignés horizontalement). Les orientations possibles sont Qt::Horizontal et Qt::Vertical.

Fonction d'accès

Qt::Orientation orientation () const

void setOrientation ( Qt::Orientation orientation )

standardButtons : StandardButtons

Cette propriété contient une liste de boutons standard dans la boîte de boutons.

La propriété contrôle les boutons standard qui sont utilisés dans la boîte de boutons.

Fonction d'accès

StandardButtons standardButtons () const

void setStandardButtons ( StandardButtons buttons )

Voir aussi addButton().

Fonctions membres

QDialogButtonBox::QDialogButtonBox ( QWidget * parent = 0 )

Construit une boîte de boutons, vide, horizontale ayant pour parent parent.

Voir aussi orientation et addButton().

QDialogButtonBox::QDialogButtonBox ( Qt::Orientation orientation, QWidget * parent = 0 )

Construit une boîte de boutons vide avec l'orientation orientation donnée et le parent parent.

Voir aussi orientation et addButton().

QDialogButtonBox::QDialogButtonBox ( StandardButtons buttons, Qt::Orientation orientation = Qt::Horizontal, QWidget * parent = 0 )

Construit une boîte de boutons avec l'orientation orientation et le parent parent, contenant les boutons standard spécifiés par buttons.

Voir aussi orientation et addButton().

QDialogButtonBox::~QDialogButtonBox ()

Détruit la boîte de boutons.

void QDialogButtonBox::accepted () [signal]

Ce signal est émis lorsqu'un des boutons de la boîte est cliqué, pour peu qu'il ait le rôle AcceptRole ou YesRole.

Voir aussi rejected(), clicked() et helpRequested().

void QDialogButtonBox::addButton ( QAbstractButton * button, ButtonRole role )

Ajoute le bouton button à la boîte de boutons avec le rôle role spécifié. Si le rôle n'est pas valide, le bouton n'est pas ajouté.

Si le bouton a déjà été ajouté, il sera retiré puis ajouté à nouveau, avec le nouveau rôle.

Note : la boîte de boutons devient propriétaire du bouton.

Voir aussi removeButton() et clear().

QPushButton * QDialogButtonBox::addButton ( const QString & text, ButtonRole role )

Crée un bouton poussoir avec le texte text donné, l'ajoute dans la boîte de boutons avec le rôle role spécifié et retourne le bouton correspondant. Si le role n'est pas valide, aucun bouton n'est créé et la fonction retourne zéro.

Voir aussi removeButton() et clear().

QPushButton * QDialogButtonBox::addButton ( StandardButton button )

Ajoute un bouton standard button à la boîte de boutons s'il est possible de le faire et retourne un bouton poussoir. Si button n'est pas valide, il n'est pas ajouté à la boîte et la fonction retourne zéro.

Voir aussi removeButton() et clear().

QPushButton * QDialogButtonBox::button ( StandardButton which ) const

Renvoie le QPushButton correspondant au bouton standard which ou 0 si le bouton standard n'existe pas dans cette boîte de boutons.

Voir aussi standardButton(), standardButtons() et buttons().

ButtonRole QDialogButtonBox::buttonRole ( QAbstractButton * button ) const

Renvoie le rôle du bouton pour le bouton button spécifié. Cette fonction retourne InvalidRole si button est 0 ou n'a pas été ajouté à la boîte de boutons.

Voir aussi buttons() et addButton().

QList<QAbstractButton *> QDialogButtonBox::buttons () const

Renvoie une liste de tous les boutons qui ont été ajoutés à la boîte de boutons.

Voir aussi buttonRole(), addButton() et removeButton().

void QDialogButtonBox::changeEvent ( QEvent * event ) [virtual protected]

Réimplémentation de QWidget::changeEvent().

void QDialogButtonBox::clear ()

Nettoie la boîte de boutons en supprimant tous les boutons à l'intérieur.

Voir aussi removeButton() et addButton().

void QDialogButtonBox::clicked ( QAbstractButton * button ) [signal]

Ce signal est émis lorsqu'un bouton dans la boîte de boutons est cliqué. Le bouton cliqué est spécifié par button.

Voir aussi accepted(), rejected() et helpRequested().

bool QDialogButtonBox::event ( QEvent * event ) [virtual protected]

Réimplémentation de QObject::event().

void QDialogButtonBox::helpRequested () [signal]

Ce signal est émis lorsqu'un bouton dans la boîte de boutons est cliqué, si le rôle de celui-ci est HelpRole.

Voir aussi accepted(), rejected() et clicked().

void QDialogButtonBox::rejected () [signal]

Ce signal est émis lorsqu'un bouton dans la boîte de boutons est cliqué, si le rôle de celui-ci est RejectRole ou NoRole.

Voir aussi accepted(), helpRequested() et clicked().

void QDialogButtonBox::removeButton ( QAbstractButton * button )

Retire le bouton button de la boîte de boutons sans le supprimer, et définit son parent à zéro.

Voir aussi clear(), buttons() et addButton().

StandardButton QDialogButtonBox::standardButton ( QAbstractButton * button ) const

Renvoie la valeur de bouton standard correspondant au bouton button donné ou NoButton si le bouton button n'est pas un bouton standard.

Voir aussi button(), buttons() et standardButtons().

Remerciements

Merci à Alexandre Laurent pour la traduction, ainsi qu'à Lo?c Leguay et Claude Leloup pour la relecture !