Codons notre première fenêtre

Un projet en Java est composé d'au moins une classe contenant une fonction main.
Selon votre IDE, vous pouvez créer un projet Java et y ajouter les librairies (qtjambi.jar en l'occurence)

Voici a quoi doit ressembler la methode main de votre objet principal :
Code : Java

C'est le code minimal d'une application Qt en java.
Comme vous pouvez le constater, c'est vraiment très court et c'est un des points forts de Qt.

Analysons Pas à Pas ...

Import ...

Code : Java
On utilise la classe QApplication de Jambi qui est la classe de base de tout programme Qt.
Il faut donc la situer dans l'arborescence pour que le compilateur java la retrouve.

J'ai utilisé le chemin complet car je n'ai utilisé que cet objet.
On peut aussi décider d'inclure tous les objets du GUI comme ceci :

Code : Java

D'un point de vue performance ça ne change rien.
D'un point de vue lisibilité du code, ça peut permettre à un programmeur de voir tout de suite de quoi il va s'agir et ce que la classe va utiliser.

Je vais dans ce cours utiliser des import explicites dans la mesure du possible (tant que ça ne nuit pas à la lisibilité).

QApplication, la classe de base

La première ligne du main crée un nouvel objet de type QApplication.
Cet objet est un Singleton (une classe dont il n'existe qu'une seule instance), cela veut dire qu'on n'en créé aucun objet, on l'utilise seulement.

À la différence du C++, il n'y a pas de constructeur puisqu'on ne créé pas d'objet QApplication.
On utilise donc la méthode statique initialize de la classe QApplication pour initialiser l'application et c'est cette méthode qui s'occupe de créer l'instance unique.

De manière à pouvoir passer des ordres (comme des options d'affichages par exemple) au framework Qt, on donne les paramètres de la ligne de commande.

Lancement de l'application

La méthode statique de la classe QApplication permet de lancer l'application.
Entre l'initialisation et l'exécution, on va créer nos objets (boites de dialogues, fenêtres, ...).
Ce n'est que lors de l'exécution de cette méthode que tout va s'enclencher.

Lorsque la méthode exec s'arrête, notre programme est terminé.

Dans la plupart des bibliothèques GUI, dont Qt fait partie, tous les éléments d'une fenêtre sont appelés des widgets. Les boutons, les cases à cocher, les images... tout ça ce sont des widgets. La fenêtre elle-même est considérée comme un widget.

Pour provoquer l'affichage d'une fenêtre, il suffit de demander à afficher n'importe quel widget. Ici par exemple, nous allons afficher un bouton.

Voici le code complet que j'aimerais que vous utilisiez. Il utilise le code de base de tout à l'heure mais y ajoute quelques lignes :

Code : Java

On a ajouté un import, celui de notre nouveau widget le QPushButton (un bouton poussoir pour les anglophobes).

On crée notre objet bouton avec comme texte "Salut les Zéros, la forme ?"
Et on l'affiche.

Comme un bouton ne peut pas "flotter" comme ça sur votre écran, Qt l'insère automatiquement dans une fenêtre. On a en quelque sorte créé une "fenêtre-bouton" .

Bien entendu, dans un vrai programme plus complexe, on crée d'abord une fenêtre et on y insère ensuite plusieurs widgets, mais là on commence simplement .

Notre code est prêt, il ne reste plus qu'à compiler et exécuter le programme !

La classe Test.java

Pour les exemples, je préfère vous donner le fichier complet :

Test.java
Code : Java

Compilation

Si vous avez tout installé convenablement, un simple javac devrait fonctionner.
Code : Console

Si votre classpath n'est pas bien défini, ça ne marchera pas ...
Je vous conseille de le définir (ça dépend de votre système d'exploitation)

Sinon, vous pouvez le définir juste pour cette commande comme cela :
Code : Console

Sous Windows ça ressemblera surement plus à :
Code : Console

Lancement

Pour les utilisateurs de Windows et Linux :
Code : Console

Pour les utilisateurs de Mac OS X :
Code : Console

Tout à l'heure, on a un peu innové en transformant le Hello World habituel par un Salut les Zéros, la forme ?

Maintenant, on peut s'amuser un petit peu avec notre fenêtre-bouton.
Ce qui serait bien serait que l'on puisse cliquer sur le bouton pour fermer la fenêtre.
On peut aussi fixer une taille par défaut ou changer la couleur et la police.
Mettre un titre à la fenêtre aussi.

Code : Java

C'est bien commenté donc je doute que vous ayez des problèmes pour comprendre.

Il y a un point un peu plus compliqué :
Code : Java

La méthode connect va nous permettre de mettre une action sur un widget.
En l'occurrence, on décide de connecter l'action cliked() de notre bouton à la méthode quit() de notre objet QApplication.

Comme QApplication est une classe statique et que la fonction connect attend une instance d'objet, la classe QApplication possède une méthode instance() qui permet de retourner l'objet de notre application principale.

Ce que je vous disais tout à l'heure à propos de QApplication, c'est qu'on l'utilisait en temps que classe statique.
Et cela est une protection. Pour être sûr que les programmeurs ne créent pas deux objets QApplication dans le même programme, les développeurs du framework ont décidé que ce serait la classe elle même qui allait gérer son propre et unique objet.

Cet objet est créé par la méthode statique initialize(). Et lorsqu'on a besoin de l'objet, on utilise la méthode statique instance() pour le récupérer.

Comme cela, on est sur de parler toujours du même objet et en plus on a pas besoin de se demander si on a accès à notre objet. Il suffit d'importer QApplication pour y avoir accès.

On importe les dépendances et ensuite on crée une simple fenêtre avec un bouton qui quitte l'application lorsque l'on clique dessus.

Si vous souhaitez compiler en ligne de commande :

Code : Console



Si vous n'avez aucune erreur, c'est que vous êtes prêts à continuer et que vous êtes relativement habiles avec Java.
Si vous avez des erreurs, c'est que tout n'est pas encore très bien configurer et qu'il vous faut relire le chapitre expliquant comment installer Qt Jambi.