Ouverture d'une boîte de dialogue avec Qt 4

Par Denys Bulant (Tutoriels Qt)
 

I. Pré-requis

• Une installation de Qt4 fonctionnelle
• une connaissance minimale du principe des signaux/slots avec Qt

II. Une introduction aux boîtes de dialogue

• non modale: l'utilisateur peut continuer d'interagir avec le reste de l'application
• modale: l'utilisateur est obligé de fermer la boîte de dialogue affichée avant de pouvoir à nouveau se servir de l'application

III. A propos de ce tutoriel

• la première est l'ouverture d'une fenêtre en appuyant sur un bouton: elle est la méthode la plus simple, mais pas forcèment la plus commune
• la seconde fait utilisation d'un menu, et vous montre comment afficher une boîte de type "A propos...". Il y est fait appel à 2 concepts supplémentaires: les menus et les actions. Le code est loin d'être compliqué, mais assurez-vous d'avoir compris la première partie pour lire la seconde.

IV. Lectrice/Lecteur, voici QDialog; QDialog, voici ton futur maître ;-)

La documentation de la classe QDialog se trouve  ici .

Cette section sert de très brève introduction aux fonctions les plus basiques de QDialog . Je vous invite à aller lire  la description détaillée sur la page de documentation de Trolltech. Ils en parlent bien mieux que moi.

IV-1. De la modalité et différences entre les fonctions d'affichage

• QDialog::show() : utilisée pour un affichage de la boîte de dialogue; par défaut l'affichage est non modal; peut servir à afficher un QDialog de façon modale si setModal(true) à été appellée précédemment.
• QDialog::hide() : permet de cacher une boite de dialogue
• QWidget::setVisible() et QWidget::isVisible() : QDialog dérive de QWidget , et fournit donc cette alternative à show()/hide() . L'utilité de ces fonctions se trouve principalement dans la possibilité de changer la visibilité d'une fenêtre en une ligne de code.
• QDialog::exec() : sert à afficher une boite de dialogue modale et éventuellement récupérer le code de retour

IV-2. Valeurs de retours

• QDialog::accept() : QDialog::Accepted sera la valeur renvoyée par exec()
• QDialog::reject() : QDialog::Rejected sera renvoyée
• QDialog::done(int) : vous permet de spécifier l'une des 2 valeurs, mais aussi de spécifier la votre si vous en avez un réél besoin (utilisation assez rare tout de même).

IV-3. Une boîte de dialogue...

class Dialog : public QDialog
{
public:
	Dialog(QWidget *parent=0)
	:QDialog(parent)
	{
		// Elle est simplement composé d'un bouton "Fermer"
		QPushButton *closeBtn = new QPushButton("Fermer", this);
		
		// lequel ferme la fenetre lorsqu'on clic dessus
		connect(closeBtn, SIGNAL(clicked()), this, SLOT(accept()));
	}
};

V. Ouverture de fenêtre avec des boutons

V-1. Classes abordées

•  QDialog : sert de classe de base aux boîtes de dialogue
•  QPushButton : déclenche l'affichage des boites de dialogue, et quitte l'application

V-2. Description de la solution

V-3. Exemple

class MainDialog : public QDialog
{
	Q_OBJECT

public:
	MainDialog(QWidget *parent=0)
	:QDialog(parent), dlg(0)
	{
		dlg = new Dialog(this);
		
		// Ce bouton nous permettra d'afficher notre boîte de dialogue
		QPushButton *modalDlgBtn = new QPushButton(" Open Modal dialog", this);

		// J'agrandis la fenetre pour que dlg soit visuellement différenciable de celle-ci
		resize(250,50);
		
		// On demande à Qt d'executer showDialogModal() lorsque le bouton est clique
		connect(modalDlgBtn, SIGNAL(clicked()), this, SLOT(showDialogModal()));
	}

private slots:
	void showDialogModal()
	{
		// on affiche la boite de dialogue de facon modale
		dlg->setModal(true);
		dlg->show();
	}
	
private:
	Dialog *dlg;
};

VI. Utilisation d'une fenêtre principale avec menus pour ouvrir une boîte de dialogue et une boite "A propos..."

VI-1. Classes abordées

•  QMainWindow : nous en dériverons pour créer une fenêtre principale avec barre de menu
•  QDialog : sert de classe de base à notre boîte de dialogue
•  QMessageBox : affichage d'un message "A propos..."
•  QAction : permet de centraliser et coordonner le comportement et l'apparence entre des choix de menus ou des boutons sur une barre d'outils (chose que nous ne verrons pas ici)

VI-2. Description de la solution

VI-3. Exemple

class MainWindow : public QMainWindow
{
Q_OBJECT
	
public:
	MainWindow(QWidget *parent=0)
	:QMainWindow(parent), dlg(0)
	{
		// Nous creons l'instance de dialogue que nous voulons afficher
		dlg = new Dialog(this);
		
		// Les actions correspondront aux items de menus
		QAction *modelessAct = new QAction("Dialogue non modale", this);
		QAction *modalAct = new QAction("Afficher dialogue modale", this);
		QAction *aboutAct = new QAction("A propos...", this);
		QAction *closeAct = new QAction("Quitter", this);
		
		// Nous créons le menu proprement dit. Nous y ajoutons les actions précédemment crées
		QMenu *menu = menuBar()->addMenu("Divers...");
		menu->addAction(modelessAct);
		menu->addAction(modalAct);
		menu->addAction(aboutAct);
		menu->addAction(closeAct);
		
		// Définition des comportements des actions
		connect(modelessAct, SIGNAL(triggered()), this, SLOT(swapShowDialogModeless()));
		connect(modalAct, SIGNAL(triggered()), this, SLOT(showDialogModal()));
		connect(aboutAct, SIGNAL(triggered()), this, SLOT(about()));
		connect(closeAct, SIGNAL(triggered()), qApp, SLOT(quit()));
	}
	
private slots:
	// Affichée de façon modeless, l'utilisateur peut continuer d'interagir avec le reste de l'application
	void swapShowDialogModeless()
	{
		// Si elle est deja affichee, on cache la boite de dialogue sinon on l'affiche
		dlg->setVisible(!dlg->isVisible());
	}
	
	// En version modale, une boite de dialogue empêche l'utilisateur d'intervenir sur une autre partie
	// de l'interface que la boite de dialogue
	void showDialogModal()
	{
		// On s'assure que notre boite de dialogue n'est pas déjà affichée de façon non modale
		if(dlg->isVisible())
		{
			QMessageBox::critical(this, "Erreur", "La boite de dialogue est déjà ouverte. Veuillez la fermer pour l'ouvrir à nouveau.");
		}
		else
		{
			dlg->exec();
		}
	}
	
	// Affichage d'information à propos de ce "logiciel"
	void about()
	{
		QMessageBox::about(this, "Tuto: Menus et dialogues",
			"Cette application est destinée à illustrer:\n" \
			"> l'ouverture de boîte de dialogue\n" \
			"> l'ouverture d'une fenetre \"A propos...\"\n" \
			"> et une rapide introduction à QAction");
	}

private:
	Dialog *dlg;
};

VII. Archive

• bouton : exemple de la première partie
• menu : exemple de la seconde

VIII. Conclusion

L'article original se situe  ici . Pour toute question, n'hésitez pas à vous rendre sur  le forum dédié à Qt sur Developpez .