Initiation à Qt Jambi

Visiteur — Sun, 25 Nov 2007 22:05:00 +0100

Ce tutoriel vous permettra de découvrir le fonctionnement de Qt Jambi progressivement.

Version : Jambi
Auteur : Natim

Ce tutoriel est disponible sur le site du zéro: y accéder.

L'utilisateur découvrira:

Comment installer Jambi
Comment créer une fenêtre de base en utilisant des layouts
Le fonctionnement des signaux et slots de Qt
et pour finir, réalisera un petit éditeur de texte et un visualisateur d'images.

Ouverture d'une boîte de dialogue à partir de la fenêtre principale

IrmatDen — Sun, 15 Apr 2007 18:24:00 +0200

Ce tutoriel est destiné aux nouveaux venus à Qt qui cherche à savoir comment ouvrir une fenêtre à partir de leur fenêtre principale. Nous verrons 2 façons de faire:

utilisation d'une fenêtre principale avec menus pour ouvrir une boîte de dialogue et une boite "A propos..."
ouverture d'une fenêtre de dialogue par le biais d'un bouton

J'en profiterais pour aborder très brièvement 2 autres points : l'utilisation de QAction et les 2 modes d'affichage des boîtes de dialogue.

Version : Qt4 (et une version pyQt disponible)
Auteur : Denys Bulant (IrmatDen), alteo_gange pour la version pyQt
Fil de discussion : Forum

Pré requis:

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

Une introduction aux boîtes de dialogue

Les boîtes de dialogue sont des composants essentiel à la très grosse majorité des applications. Qu'il s'agisse de boîte de configuration ou de fournir une interactivité à un niveau plus ou moins bas avec le document ouvert (par exemple, la recherche dans un traitement de texte ou un tableur), vous aurez souvent l'occasion d'en utiliser.

On distingue 2 types d'utilisation des 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

Chaque usage à son but; par exemple, une boîte de dialogue permettant une recherche dans un document aura tout intérêt à être non modale par souci d'ergonomie. Par contre, une fenêtre de configuration devrait plutôt être modale, dûe à une éventuelle dépendance du résultat sur le comportement de l'application.

A propos de ce tuto

Ce tuto vous permettra, je l'espère de vous familiariser avec QDialog principalement, et plus globalement l'ouverture de fenêtre à partir d'une autre. Je fourni ici 2 approches:

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.

Comme dit dans l'introduction, une version pyQt a été réalisée par alteo_gange. Elle est disponible sur le forum.

Partie 0: Lectrice/Lecteur, voici QDialog; QDialog, voici ton futur maître ;-)

Avant de sauter dans le vif du sujet, faisons plus ample connaissance avec la classe QDialog. Vous vous en doutez probablement, elle réalise ce qu'une boîte de dialogue est sensée faire, et permet quelques raccourcis que vous n'auriez pas si vous dériviez d'un QWidget.

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.

De la modalité et différences entre les fonctions d'affichage

Afficher une instance de QDialog peut se faire de plusieurs façons. En voici un aperçu:

QDialog::show(): QDialog::show(): utilisé 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é 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

Valeurs de retours

Il peut être parfois utile de savoir si l'interaction demandée à l'utilisateur par le biais de votre boîte de dialogue à réussi ou échoué (dans le cas d'une boîte modale). QDialog::exec() renvoit un code d'erreur qui est soit QDialog::Accepted, soit QDialog::Rejected (ou encore une de vos valeurs propres dans des cas peu courants). La première valeur signifie un succès, tandis que la seconde indique soit un échec, soit un refus ou une annulation. Du côté de votre boîte de dialogue, vous pouvez renvoyer ces valeurs de diverses façons:

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).

Une boîte de dialogue...

La classe définie ici sera celle que nous allons afficher dans les 2 exemples suivant. Elle n'est composée que d'un bouton "Fermer".

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()));
	}
};

Partie 1: ouverture de fenêtre avec des boutons

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

Description de la solution

Bien que rarement utilisée/utilisable à cause du "clicodrome" qui risque d'être engendré (affichage d'une boîte de dialogue qui en appelle une autre qui... :)), cette méthode permet d'illustrer simplement l'ouverture d'une boîte de dialogue. Ceci dit, il peut toujours y avoir besoin d'une telle utilisation, ne serait-ce que parce que votre widget principal ne possède pas de menu.

Exemple

Voici la classe principale. C'est à partir de celle-ci que nous allons demander l'ouverture d'une instance de Dialog

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;
};

Partie 2: utilisation d'une fenêtre principale avec menus pour ouvrir une boîte de dialogue et une boite "A propos..."

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)

Description de la solution

Nous allons utiliser ici un menu pour permettre d'ouvrir une boîte de dialogue de façon modale, non modale, et enfin une descrption de ce petit code. La classe QAction permet d'ajouter des fonctionnalités à un menu, ainsi qu'à d'éventuelles barre d'outils.

Exemple

C'est à partir de l'interface décrite ci-dessous que nous allons demander l'ouverture d'une instance de Dialog, que ce soit de façon modale ou non.

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;
};

Documentation Qtfr - class_QMenu

Initiation à Qt Jambi

Ouverture d'une boîte de dialogue à partir de la fenêtre principale

Pré requis:

Une introduction aux boîtes de dialogue

A propos de ce tuto

Partie 0: Lectrice/Lecteur, voici QDialog; QDialog, voici ton futur maître ;-)

De la modalité et différences entre les fonctions d'affichage

Valeurs de retours

Une boîte de dialogue...

Partie 1: ouverture de fenêtre avec des boutons

Classes abordées:

Description de la solution

Exemple

Partie 2: utilisation d'une fenêtre principale avec menus pour ouvrir une boîte de dialogue et une boite "A propos..."

Classes abordées:

Description de la solution

Exemple

Archive