{{tag>dev pygtk widget conteneur}}

====== Agencer les widgets ======

Pour organiser les différents composants de l'interface graphique (widgets) PyGTK propose un système de boites (box) qui sont des conteneurs invisibles à l’intérieur desquels on insère les widgets. Il existe deux familles: les conteneurs verticaux et les horizontaux. Dans un conteneur horizontal, les objets insérés sont placés les un à la suite des autres en file indienne. Dans un conteneur vertical, les objets seront disposés verticalement les uns sous les autres. Les boites s'imbriquent à volonté afin de produire l'effet désiré.

En travaillant avec les conteneurs, l'apparence d'un widget en taille et proportion peut sensiblement différer de ce à que l'on souhaitait obtenir. C'est une conséquence du fonctionnent interne du système de boites proposé par GTK+. La taille d'un widget va dépendre de la façon dont il est regroupé avec les autres widget mais également de la façon dont son propre conteneur l'autorise ou non à s’étendre ou occuper l'espace disponible.

L'espace que chacun occupera est déterminée par:
  * Les tailles requises ou par défaut de chaque widget qui dépendent normalement de leur contenu (en particuliers les labels).
  * La valeur des arguments **expand** et **fill** fournis lors de l'insertion du widget dans le conteneur.

^ expand= True | Le widget aura la possibilité de consommer l'espace disponible |
^ expand= False| Le widget ne consommera pas plus d'espace que necessaire |
^ fill= True   | Le widget rempli de son contenu l'espace supplémentaire |
^ fill= False  | l'espace supplémentaire est utilise comme marge |

<note>
Ces comportements peuvent paraître assez complexes à appréhender au départ mais ils sont indispensables lorsqu'on souhaite utiliser correctement toutes les fonctionnalités de redimensionnement dynamique des fenêtres.
</note>

Ci-dessous un exemple de signature avec la méthode pack_start() disponible sur les conteneurs:

<code python>
box.pack_start(child, expand=True, fill=True, padding=0)
</code>

**child** est l'objet que l'on souhaite insérer dans le conteneur. L'argument **expand** permet de contrôler l’expansion du conteneur. Si **expand=False**, le widget placé dans le conteneur occupera seulement l'espace nécessaire. Si **expand=True**, l'espace supplémentaire est utilisé par le  conteneur se développe pour occuper tout l'espace disponible. L'argument **fill** permet de définir si l'espace supplémentaire est disponible pour les widgets eux-même (**fill=True**) ou pour l’écartement des objets entre-eux (**fill=False**). Il aura un effet seulement si l'argument expand=True

===== Exemples =====

Dans les exemples ci-dessous, en mode interactif on crée une fenêtre puis un conteneur horizontal à l’intérieur duquel 4 boutons sont placés. On fait varier les valeurs des arguments **expand**, **fill** et **padding**.

| <code python> 
box.pack_start(bt1, False, False)
box.pack_end(bt2, False, False)
box.pack_start(bt3, False, False)
box.pack_start(bt4, False, False)
</code>   | {{dev:python:pygtk:pygtk-packing-01.png}} |

| <code python> 
box.pack_start(bt1, True, False)
box.pack_end(bt2, True, False)

</code>   | {{dev:python:pygtk:}} |


<code python>
box = gtk.HBox(homogeneous=False, spacing=0)
</code>

L'argument **spacing** donné à la création du conteneur est différent de l'argument **padding** spécifié lors de l'insertion de l'objet dans le conteneur (packing). la valeur spacing est ajoutée entre les objets

<code python>
box= gtk.HBox(homogeneous=False, spacing=20)
box.pack_start(boutons[0], expand=False, fill=False, padding=0)
box.pack_start(boutons[1], expand=False, fill=False, padding=0)
</code>

Dans cet exemple on définit un espace de 20 pixels entre chaque objets dans le conteneur. Lors du packing des boutons on spécifie que ceux-ci n'occuperont pas l'espace supplémentaire disponible expand=False. Le résultat ci-dessous:

{{dev:python:pygtk:pygtk-packing-03.png}}


Le **padding** ou rembourrage est une marge présente de chaque coté du widget.
<code python>
box = gtk.HBox(homogeneous=False,spacing=0)
box.pack_start(boutons[0],padding=20)
box.pack_start(boutons[1],padding=10)
</code>

Ici, pour le bouton 0, une marge a été définie a 20 pixel de chaque coté. Les arguments **expand** et **fill** de la méthode **pack_start()** n'ont pas été précisés. Ils prennent donc leur valeur par défaut (True). Le bouton rempliera l'espace supplémentaire disponible. De même pour le second bouton mais la marge a été fixée à 10. Ci-dessous le résultat obtenu:

{{dev:python:pygtk:pygtk-packing-04.png}}

===== Tableau =====

Pour l'agencement des widget, PyGTK met à disposition le conteneur gtk.Table

<code python>
table = gtk.Table(rows=1, columns=1, homogeneous=False)
</code>

L'argument **homogeneous** permet de spécifier comment les boites du tableau sont redimensionnées. Si **homogeneous= True**, les boites auront toutes la dimension du widget le plus grand contenu dans le tableau. Si la valeur de homogeneous est False, la taille d'un élément en hauteur sera celle du widget le plus grand sur la même ligne et sa longueur sera celle du plus long de la colonne.

Pour placer des widgets dans un objet de type Table, utiliser la méthode attach:

<code python>
object.attach(child, left_attach, rigt_attach, top_attach, bottom_attach
              xoptions=EXPAND|FILL, yoptions:EXPAND|FILL, xpadding=0, ypadding= 0)
</code>


===== Références =====

  * PyGTK 2.0 Tutorial, chapitre 4