QDialog Class

Description détaillée

Une fenêtre de dialogue est une fenêtre de premier niveau principalement utilisée pour des tâches de courte durée et de brèves communications avec l'utilisateur. Les QDialogs peuvent être modales ou sans modèle. Les QDialogs peuvent fournir un return value, et ils peuvent avoir un default buttons. Les QDialogs peuvent également avoir un QSizeGrip dans leur coin inférieur droit, en utilisant setSizeGripEnabled().

Notez que QDialog (et tout autre widget de type Qt::Dialog) utilise le widget parent légèrement différemment des autres classes de Qt. Un dialogue est toujours un widget de premier niveau, mais s'il a un parent, son emplacement par défaut est centré sur le widget de premier niveau du parent (s'il n'est pas lui-même de premier niveau). Il partage également l'entrée de la barre des tâches du parent.

Utilisez la surcharge de la fonction QWidget::setParent() pour modifier la propriété d'un widget QDialog. Cette fonction vous permet de définir explicitement les drapeaux de fenêtre du widget réparti ; l'utilisation de la fonction surchargée effacera les drapeaux de fenêtre spécifiant les propriétés du système de fenêtres pour le widget (en particulier, elle réinitialisera le drapeau Qt::Dialog ).

Dialogues modaux

Une boîte de dialogue modale est une boîte de dialogue qui bloque la saisie d'autres fenêtres visibles dans la même application. Les boîtes de dialogue utilisées pour demander un nom de fichier à l'utilisateur ou pour définir les préférences de l'application sont généralement modales. Les boîtes de dialogue peuvent être application modal (par défaut) ou window modal.

Lorsqu'une boîte de dialogue modale est ouverte, l'utilisateur doit finir d'interagir avec la boîte de dialogue et la fermer avant de pouvoir accéder à une autre fenêtre de l'application. Les boîtes de dialogue modales de fenêtre ne bloquent que l'accès à la fenêtre associée à la boîte de dialogue, ce qui permet à l'utilisateur de continuer à utiliser les autres fenêtres de l'application.

La manière la plus courante d'afficher une boîte de dialogue modale est d'appeler sa fonction open(). Vous pouvez également appeler setModal(true) ou setWindowModality(), puis show(). Dans les deux cas, une fois la boîte de dialogue affichée, le contrôle est immédiatement rendu à l'appelant. Vous devez vous connecter au signal finished() pour savoir quand la boîte de dialogue est fermée et quel est son return value. Vous pouvez également vous connecter aux signaux accepted() et rejected().

Lors de l'implémentation d'une boîte de dialogue personnalisée, pour fermer la boîte de dialogue et renvoyer une valeur appropriée, connectez un bouton par défaut, par exemple un bouton OK, à l'emplacement accept(), et un bouton Annuler à l'emplacement reject(). Vous pouvez également appeler l'emplacement done() avec Accepted ou Rejected.

Si vous affichez la boîte de dialogue modale pour effectuer une opération de longue durée, il est recommandé d'effectuer l'opération dans un fil d'exécution en arrière-plan, afin de ne pas interférer avec le fil d'exécution de l'interface graphique.

Dialogues sans modèle

Une boîte de dialogue sans modèle est une boîte de dialogue qui fonctionne indépendamment des autres fenêtres de la même application. Les boîtes de dialogue de recherche et de remplacement dans les traitements de texte sont souvent sans modèle pour permettre à l'utilisateur d'interagir à la fois avec la fenêtre principale de l'application et avec la boîte de dialogue.

Les boîtes de dialogue sans modèle sont affichées à l'aide de show(), qui redonne immédiatement le contrôle à l'appelant.

Si vous invoquez la fonction show() après avoir masqué une boîte de dialogue, celle-ci sera affichée dans sa position initiale. En effet, le gestionnaire de fenêtres décide de la position des fenêtres qui n'ont pas été placées explicitement par le programmeur. Pour préserver la position d'une boîte de dialogue qui a été déplacée par l'utilisateur, enregistrez sa position dans votre gestionnaire closeEvent(), puis déplacez la boîte de dialogue à cette position avant de la réafficher.

Bouton par défaut

Le bouton par défaut d'une boîte de dialogue est le bouton qui est enfoncé lorsque l'utilisateur appuie sur Entrée (Return). Ce bouton est utilisé pour indiquer que l'utilisateur accepte les paramètres de la boîte de dialogue et souhaite la fermer. Utilisez QPushButton::setDefault(), QPushButton::isDefault() et QPushButton::autoDefault() pour définir et contrôler le bouton par défaut de la boîte de dialogue.

Touche d'échappement

Si l'utilisateur appuie sur la touche Esc dans une boîte de dialogue, QDialog::reject() est appelé. Cela entraîne la fermeture de la fenêtre : Le site close event ne peut pas être ignored.

Extensibilité

L'extensibilité est la possibilité d'afficher la boîte de dialogue de deux manières : une boîte de dialogue partielle qui affiche les options les plus couramment utilisées et une boîte de dialogue complète qui affiche toutes les options. En règle générale, une boîte de dialogue extensible apparaît initialement comme une boîte de dialogue partielle, mais avec un bouton de basculement More. Si l'utilisateur appuie sur le bouton de basculement , la boîte de dialogue complète s'affiche. Si l'utilisateur appuie sur le bouton More, la boîte de dialogue est développée.

Valeur de retour (boîtes de dialogue modales)

Les boîtes de dialogue modales sont souvent utilisées dans des situations où une valeur de retour est nécessaire, par exemple pour indiquer si l'utilisateur a appuyé sur OK ou Cancel. Une boîte de dialogue peut être fermée en appelant les slots accept() ou reject(), et exec() renverra Accepted ou Rejected selon le cas. L'appel à exec() renvoie le résultat du dialogue. Le résultat est également disponible à partir de result() si le dialogue n'a pas été détruit.

Pour modifier le comportement de fermeture de votre boîte de dialogue, vous pouvez réimplémenter les fonctions accept(), reject() ou done(). La fonction closeEvent() ne doit être réimplémentée que pour préserver la position de la boîte de dialogue ou pour remplacer le comportement standard de fermeture ou de rejet.

Exemples de code

Une boîte de dialogue modale :

void EditorWindow::countWords()
{
    WordCountDialog dialog(this);
    dialog.setWordCount(document().wordCount());
    dialog.exec();
}

Une boîte de dialogue sans modèle :

void EditorWindow::find()
{
    if (!findDialog) {
        findDialog = new FindDialog(this);
        connect(findDialog, &FindDialog::findNext,
                this, &EditorWindow::findNext);
    }

    findDialog->show();
    findDialog->raise();
    findDialog->activateWindow();
}

Un dialogue avec une extension :

mainLayout->setSizeConstraint(QLayout::SetFixedSize);

findButton = new QPushButton(tr("&Find"));
moreButton = new QPushButton(tr("&More..."));
moreButton->setCheckable(true);

extension = new ExtendedControls;
mainLayout->addWidget(extension);
extension->hide();

connect(moreButton, &QAbstractButton::toggled, extension, &QWidget::setVisible);

En définissant la propriété sizeConstraint de la disposition de la boîte de dialogue sur SetFixedSize, la boîte de dialogue ne sera pas redimensionnable par l'utilisateur et se réduira automatiquement lorsque l'extension sera masquée.