QDialogButtonBoxLa 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éritageHérite de QWidget. Cette classe a été introduite dans Qt 4.2. Description détailléeLa 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 :
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 :
Les boutons sont disposés de la manière suivante si la boîte de boutons est verticale:
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:
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. Typeenum QDialogButtonBox::ButtonLayoutCette é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::ButtonRoleCette é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::StandardButtonsCette é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éscenterButtons : boolCette 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èsbool centerButtons () const void setCenterButtons ( bool center ) Voir aussi QMessageBox. orientation : Qt::OrientationCette 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èsQt::Orientation orientation () const void setOrientation ( Qt::Orientation orientation ) standardButtons : StandardButtonsCette 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èsStandardButtons standardButtons () const void setStandardButtons ( StandardButtons buttons ) Voir aussi addButton(). Fonctions membresQDialogButtonBox::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 ) constRenvoie 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 ) constRenvoie 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 () constRenvoie 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 ) constRenvoie 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(). RemerciementsMerci à Alexandre Laurent pour la traduction, ainsi qu'à Lo?c Leguay et Claude Leloup pour la relecture ! |
Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. | Qt 4.7 | |
Copyright © 2024 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD. | ||
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP ! |