Cherche documentation du format XML de GtkBuilder

Version imprimable

06/03/2018, 15h43
Hervé Saladin

Cherche documentation du format XML de GtkBuilder

Bonjour à tou(te)s,

je développe une appli avec GTKmm 2, je suis actuellement en train de bosser sur l'interface décrite en XML et chargée à l’exécution via la classe GTK::Builder.
Or, à chaque étape, j'ai énormément de mal à trouver les informations dont j'ai besoin : quand je fais des recherches sur Google je n'obtiens que du bruit ... et je ne trouve pas la doc !
Quelqu'un aurait un lien vers la documentation du format XML accepté par Gtk::Builder dans Gtk2 SVP ?
(ou au moins les principales balises et propriétés).

Merci d'avance ! ;)
06/03/2018, 20h31
gerald3d

Bonjour.

Je pense que tu l’as déjà lu mais finalement la courte description dans la documentation officielle me semble répondre un temps soit peu à la question.https://developer.gnome.org/gtk3/sta...er.description
07/03/2018, 09h03
aeiou

Slt,

Peut-être que le DTD t'apportera quelques infos en plus...

https://developer.gnome.org/libglade...glade-dtd.html

PS: D'après mes recherches sur google, "Glade" est un mot cléf productif contrairement au mot clef "GtkBuilder"
07/03/2018, 10h49
liberforce

Citation:

Envoyé par aeiou

Slt,

Peut-être que le DTD t'apportera quelques infos en plus...

https://developer.gnome.org/libglade...glade-dtd.html

Surtout pas malheureux, là c'est le DTD associé à la libglade, ancienne bibliothèque qui a été refondue avant d'être intégrée dans GTK+ sous la forme de GtkBuilder.
Le problème c'est que les formats sont différents, et donc non compatibles. Par convention les fichier au format GtkBuilder générés par Glade ont l'estension .ui, et les anciens fichiers pour libglade sont des fichiers .glade.

Pour revenir à la question d'origine, la documentation est celle de GtkBuilder, qui fournit un lien vers le fichier au format Relax NG décrivant la syntaxe d'un fichier .ui au format GtkBuilder. Les liens sont pour l'API en C, mais le format est identique. Étrangement, je n'ai pas trouvé l'équivalent dans la documentation de GTKmm, c'est peut être un bug de documentation. Dans le doute, quand tu ne trouves pas certaines informations, la référence est la documentation de l'API en C.
07/03/2018, 10h59
liberforce

Ah, je n'avais pas vu que tu utilises GTK+ 2. Bon, déjà je te conseille si tu en as la possibilité de migrer à GTK+ 3 sorti depuis déjà 8 ans (et GTK+ 4 pointe le bout de son nez) !

Ensuite, j'ai cherché dans l'historique git le fichier de syntaxe pour la version exacte de GTK+ que tu utilises, il n'existe pas. Il a commencé à être intégré au source il y a 6 ans seulement, donc avec GTK+ 3, mais le format doit être identique. Je ne comprends en revanche pas ce que tu comptes faire des ces informations... Si tu utilises Glade pour créer tes fichiers et indiques avec quelle version tu veux être compatible, tu n'as jamais besoin de mettre le nez dans le format. Simple curiosité ?
07/03/2018, 16h03
Hervé Saladin

Merci pour vos réponses,

Citation:

la courte description dans la documentation officielle me semble répondre un temps soit peu à la question.https://developer.gnome.org/gtk3/sta...er.description

Citation:

Peut-être que le DTD t'apportera quelques infos en plus...
https://developer.gnome.org/libglade...glade-dtd.html

Citation:

la documentation est celle de GtkBuilder, qui fournit un lien vers le fichier au format Relax NG décrivant la syntaxe d'un fichier .ui au format GtkBuilder.

OK, bon ... les DTD/rnc c'est mieux que rien du tout, mais bon c'est quand-même un peu maigre comme doc je trouve ... (c'est pas de votre faute, hein, c'est déjà ça donc merci).

Citation:

Dans le doute, quand tu ne trouves pas certaines informations, la référence est la documentation de l'API en C.

OK, bon à savoir.

Citation:

Bon, déjà je te conseille si tu en as la possibilité de migrer à GTK+ 3

Peut-être un jour, plus tard, mais pas maintenant.

Citation:

Je ne comprends en revanche pas ce que tu comptes faire des ces informations... Si tu utilises Glade pour créer tes fichiers et indiques avec quelle version tu veux être compatible, tu n'as jamais besoin de mettre le nez dans le format. Simple curiosité ?

Alors ce que je fais, plus précisément : j'ai une appli dont l'interface était entièrement codée directement en C++, et là je suis en train de remplacer autant que possible de ce code par un fichier de description XML, afin de rendre ça plus pratique à modifier à l'avenir.
J'ai utilisé Glade au début, mais déjà j'ai eu beaucoup de bugs (plantages brutaux de Glade, pourtant à jour sous Ubuntu ...) et puis il y a pas mal de trucs qui me paraissent pas clairs ou que je ne comprends pas bien dans Glade (sûrement à cause de mon manque de connaissances) et enfin j'ai des widgets faits maison que Glade ne connaît pas ... bref, au bout d'un moment ça m'a saoulé et je trouve finalement plus pratique et plus confortable d'éditer directement le XML à la main dans un éditeur de texte.

Mais le problème, c'est que le code C++ de mon appli fait plein de trucs que je n'ai pas trouvé dans Glade et que je ne sais pas traduire dans le format XML ...
Par exemple (c'est juste un exemple pour illustrer, pas la peine d'y répondre) pour changer la couleur de fond d'une fenêtre en C++ c'est facile :

Code:

maFenetre.modify_bg(Gtk::STATE_NORMAL, Gdk::Color("#FFFFFF"));

Mais avec Glade ou directement en XML, j'ai toujours pas trouvé ...
Même chose pour affecter 2 boutons radio au même groupe (afin qu'on ne puisse cocher que l'un des deux à la fois) etc etc ... en résumé : j'ai du mal à savoir comment faire en XML ce qui marche bien en C++.
Et les DTD/rnc ne donnent malheureusement pas le "name" des "property" disponibles, ni de mapping du c++ vers XML ... bref, je rame.
07/03/2018, 16h51
aeiou

Tu peux trouver les "name" des "properties" dans la documentation Gtk. Par exemple, à la page https://developer.gnome.org/gtk3/stable/GtkWidget.html en cliquant sur le lien qui s'appel "properties" tu a une liste exhaustive des propriétés d'une classe.

Pour ce qui est des styles, j'ai envie de te dire : crée un fichier de style (/usr/share/themes/Ambiance/gtk-2.0/apps/saladin.rc)
07/03/2018, 17h04
Hervé Saladin

Citation:

Tu peux trouver les "name" des "properties" dans la documentation Gtk. Par exemple, à la page https://developer.gnome.org/gtk3/stable/GtkWidget.html en cliquant sur le lien qui s'appel "properties" tu a une liste exhaustive des propriétés d'une classe.

Ah yes, super, merci ! ;)

Effectivement, la doc de Gtk donne des infos utiles qui ne sont pas dans celle de GTKmm ...

Citation:

Pour ce qui est des styles, j'ai envie de te dire : crée un fichier de style (/usr/share/themes/Ambiance/gtk-2.0/apps/saladin.rc)

Bien que j'utilise Linux sur mon poste, l'appli est destinée à être déployéee sous MS Windows uniquement (utilisation de matériel nécessitant une lib propriétaire :?).
C'est possible de faire quelque chose de similaire sous Win avec Gtk2 et de fournir/packager/autoinstaller le fichier de styles avec l'appli ?

Citation:

Même chose pour affecter 2 boutons radio au même groupe (afin qu'on ne puisse cocher que l'un des deux à la fois)

Chez moi ca marche, en prenant soins d'ajouter le group (<property name="group">radiobutton1</property>)

Code:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
<?xml version="1.0" encoding="UTF-8"?>
<!-- Generated with glade 3.18.3 -->
<interface>
  <requires lib="gtk+" version="3.12"/>
  <object class="GtkWindow" id="window1">
    <property name="can_focus">False</property>
    <child>
      <object class="GtkBox" id="box1">
        <property name="visible">True</property>
        <property name="can_focus">False</property>
        <property name="orientation">vertical</property>
        <child>
          <object class="GtkRadioButton" id="radiobutton1">
            <property name="label" translatable="yes">radiobutton</property>
            <property name="visible">True</property>
            <property name="can_focus">True</property>
            <property name="receives_default">False</property>
            <property name="xalign">0</property>
            <property name="active">True</property>
            <property name="draw_indicator">True</property>
            <property name="group">radiobutton1</property>
          </object>
          <packing>
            <property name="expand">False</property>
            <property name="fill">True</property>
            <property name="position">0</property>
          </packing>
        </child>
        <child>
          <object class="GtkRadioButton" id="radiobutton2">
            <property name="label" translatable="yes">radiobutton</property>
            <property name="visible">True</property>
            <property name="can_focus">True</property>
            <property name="receives_default">False</property>
            <property name="xalign">0</property>
            <property name="active">True</property>
            <property name="draw_indicator">True</property>
            <property name="group">radiobutton1</property>
          </object>
          <packing>
            <property name="expand">False</property>
            <property name="fill">True</property>
            <property name="position">1</property>
          </packing>
        </child>
        <child>
          <object class="GtkRadioButton" id="radiobutton3">
            <property name="label" translatable="yes">radiobutton</property>
            <property name="visible">True</property>
            <property name="can_focus">True</property>
            <property name="receives_default">False</property>
            <property name="xalign">0</property>
            <property name="active">True</property>
            <property name="draw_indicator">True</property>
            <property name="group">radiobutton1</property>
          </object>
          <packing>
            <property name="expand">False</property>
            <property name="fill">True</property>
            <property name="position">2</property>
          </packing>
        </child>
      </object>
    </child>
  </object>
</interface>

Citation:

Pour ce qui est des styles

C'est possible de faire quelque chose de similaire sous Win avec Gtk2 et de fournir/packager/autoinstaller le fichier de styles avec l'appli ?

Peut etre que ce lien indique la marche a suivre : https://www.developpez.net/forums/d6...-sous-windows/

07/03/2018, 17h25
Hervé Saladin

Super.

Avec les différents éléments fournis par chacun d'entre-vous je devrais arriver à me débrouiller, je marque comme résolu

Un grand merci à vous tous ;)
09/03/2018, 14h45
liberforce

Citation:

Envoyé par aeiou

Tu peux trouver les "name" des "properties" dans la documentation Gtk. Par exemple, à la page https://developer.gnome.org/gtk3/stable/GtkWidget.html en cliquant sur le lien qui s'appel "properties" tu a une liste exhaustive des propriétés d'une classe.

Pour info, je pense que dans la doc GTKmm il suffit de chercher les méthodes property_* pour avoir la liste des propriétés. C'est certes moins pratique.

Citation:

Envoyé par aeiou

Pour ce qui est des styles, j'ai envie de te dire : crée un fichier de style (/usr/share/themes/Ambiance/gtk-2.0/apps/saladin.rc)

Je confirme, c'est le boulot du moteur de thèmes. J'ajoute que le système de style a changé complètement entre GTK+2 et GTK+ 3 (GTK+ 3 utilise CSS pour styler les widgets), donc ce travail sera à refaire en cas de migration.

Enfin, j'ajoute qu'il y a GtkInspector (s'il ne fonctionne pas avec GTK+ 2, utiliser GtkParasite) qui permet d'analyser comment est construite une interface. Ça peut aider quand on cherche à reproduire une interface créée programmaticalement.