✎ glade [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

====== Glade ======

Glade est un outil interactif de conception d'interface graphique GTK+. Il prend en charge toute la partie de gestion/génération de l'interface pour permettre au développeur de se concentrer sur le code « utile ».

Glade enregistre les interfaces graphiques en générant des fichiers XML. La bibliothèque libglade permet de lire ces fichiers dynamiquement (c’est-à-dire à l'exécution de l'application). Grâce à libglade, ces fichiers XML peuvent être utilisés par de nombreux langages de programmation tels que C, C++, Java, Perl, Python, C#, PHP (extension PHP-GTK), Pike, Ruby, Haskell, Objective Caml et Scheme.

La version 2.x permet de générer directement le code en C, C++ et Ada 95. Cependant, cette fonctionnalité a disparu à partir de la version 3.x car elle était déconseillée pour différentes raisons. Glade 2 est néanmoins toujours disponible sur le site officiel.

[[http://live.gnome.org/Glade/Tutorials|Documentation officielle]] sur le [[http://glade.gnome.org/|site officiel]].

<note tip>
À partir de la version 3.0, Glade dépend de GTK+ 2.8 et libxml2.

Il faut savoir que pour les paquets disponibles sous Hardy (et vraisemblablement dans les distributions plus récentes), il n'est pas encore possible d'utiliser directement GTKBuilder pour charger des fichiers XML générés par Glade, alors que la documentation des sites officiels (GTK, GTKmm), plus à jour, indique que c'est possible. Plus d'infos sur http://www.micahcarrick.com/05-30-2008/gtk-builder-libglade-faq.html#1 </note>

===== Installation =====

[[:tutoriel:comment_installer_un_paquet|Installez le paquet]] [[apt://glade|glade]].

<note tip>Le paquet **glade** correspond à la version 3 sur Ubuntu 9.10 "Karmic Koala". Sur les versions précédentes, pour avoir Glade 3 il faut installer le paquet [[apt://glade-3]]. Sur Ubuntu 9.10, Glade 2 est disponible en installant le paquet [[apt://glade-2]]
</note>

===== Exemple de programmation =====

Exemple tiré de : http://planet.ubuntu-fr.org/tag/Glade

Pour ce qui est de la fenêtre que l’on va faire on va gagner du temps et utiliser directement une boîte de dialogue qui comporte déjà 2 parties utiles. A savoir, une partie vide ainsi que une spécialement faite pour y mettre des boutons. Réalisons donc une interface ressemblant à ceci, avec une arborescence identique à celle proposée sur l’image ci-dessous. Le fichier Glade est disponible dans l’archive et se nomme PasswordGenerator.glade.

Une fois l’interface réalisée, il faut maintenant l’exploiter avec le code Java et lui faire réaliser les actions que l’on souhaite. Tout d’abord, qu’est-ce que l’on voit sur cette interface GTK+ ? On remarque qu’il y a 4 checkboxes correspondant à l’utilisation (case cochée, par défaut) ou non (case décochée) des types de caractères. On voit aussi une barre pour choisir la taille du mot de passe (valeur par défaut 8). On sait tous qu’un vrai mot de passe se compose d’au moins 8 caractères avec alternance majuscules, minuscules, chiffres et caractères spéciaux. Enfin, il y a 3 boutons, un bouton Quitter (qui veut tout dire), un Actualiser qui va permettre de générer le mot de passe (qui se situera dans la champ de texte) et un bouton Copier pour copier le mot de passe dans le presse-papier. Tous ces boutons sont des boutons “basiques” dont l’icône, le label et le mnemonic sont déjà définis. Nous allons donc voir seulement les actions associées à ses boutons. Pour le reste il vous suffira de voir le code. Ce n’est pas très complexe et il y a des commentaires.

Commençons par le bouton Quitter. Ce dernier a pour effet de terminer le programme. Voilà comment on code ceci.
<code>
    // Exit button
    Button exitButton = (Button) _glade.getWidget("exit_button");
    exitButton.connect(new Button.Clicked() {
        @Override
        public void onClicked(Button source) {
            Gtk.mainQuit();
        }
    });

</code>
On récupère l’élément bouton et au clic sur ce bouton on applique l’action Gtk.mainQuit() qui termine la boucle lancée par Gtk.main().

Après ceci, occupons-nous du bouton Actualiser qui lancera la génération du mot de passe. Idem on récupère le bouton mais au clic on lui applique une autre méthode que l’on a créée auparavant.

<code>
    // Refresh button
    Button applyButton = (Button) _glade.getWidget("apply_button");
    applyButton.connect(new Button.Clicked() {
        @Override
        public void onClicked(Button source) {
            GtkInterface.this.generatePassword();
        }
    });
</code>

C'est La méthode generatePassword() qui va vraiment se charger de récupérer un mot de passe et d’actualiser le champ de texte de l’interface.
<code>
    private void generatePassword() {
        boolean[] checks = { _digitCheck.getActive(), _upperCheck.getActive(),
                _lowerCheck.getActive(), _specialCheck.getActive() };
        int length = (int) _lengthScale.getValue();

if (!checks[0] && !checks[1] && !checks[2] && !checks[3])
            this.errorDialog(Languages.ERROR, Languages.CHECKBOX_ERROR);
        else {
            String password = Password.randomPassword(length, checks);
            _passwordEntry.setText(password);
        }
    }
</code>
On récupère la longueur du mot de passe. Et là un test, si on a décoché toutes les cases, on signale une erreur à l’utilisateur via une fenêtre spéciale appelée par la méthode errorDialog(String title, String text).

Pour finir, on définit l’action du bouton Copier. On va bien entendu copier le mot de passe dans le presse-papier dans le but de le coller plus tard.
<code>
    // Copy button
    Button copyButton = (Button) _glade.getWidget("copy_button");
    copyButton.connect(new Button.Clicked() {
        @Override
        public void onClicked(Button source) {
            GtkInterface.this.copyToClipboard(_passwordEntry.getText());
        }
    });
</code>
C’est la méthode copyToClipboard(String text) qui va copier le contenu du champ texte dans le presse-papier si bien entendu l’environnement le supporte. Mais ça ne devrait pas poser de problème. Voici le contenu de cette méthode.
<code>    private void copyToClipboard(String password) {
        try {
            StringSelection selection = new StringSelection(
                    password == null ? "" : password);
            Toolkit.getDefaultToolkit().getSystemClipboard().setContents(
                    selection, null);
        } catch (IllegalStateException e) {
            this.errorDialog(Languages.ERROR, Languages.COPY_ERROR);
        }
    }
</code>

N’oubliez pas surtout de regarder tous les autres fichiers pour comprendre le code et tous les appels de méthodes. Et normalement, après compilation (via le script Ant), Il ne reste qu’à dézipper le fichier .zip généré, donner les droits d’exécution au script shell et le lancer (on peut aussi utiliser le Run de Eclipse). Après tout ceci, on obtient notre joli générateur de mot de passe sans aucun problème.
Si vous avez des questions, besoin de plus d’explication, n’hésitez pas à demander.

===== Tutoriaux =====
==== Francais ====

* http://www.gtk-fr.org/wakka.php?wiki=LibGlade
  * http://daniel.coquette.free.fr/dotclear/index.php/post/2006/12/11/Creer-des-interfaces-graphique-avec-PyGTK-et-Glade
  * http://daniel.coquette.free.fr/dotclear/index.php/post/2006/12/18/Construire-une-application-avec-PyGTK-et-Glade
  * http://www.siteduzero.com/tutoriel-3-93858-glade.html

==== Anglais ====

* http://www.micahcarrick.com/12-24-2007/gtk-glade-tutorial-part-1.html
  * http://www.kplug.org/glade_tutorial/glade2_tutorial/glade2_introduction.html
  * http://www.haskell.org/gtk2hs/docs/tutorial/glade/

Merci de recopier le code ci-contre pour prouver que vous êtes humain : Z R U J X Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported