✎ tkinter [Wiki ubuntu-fr]

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

{{tag> programmation BROUILLON}}
----
====== Créer des interfaces graphiques avec Tkinter ======

===== Présentation =====

**Tkinter** est une librairie basique mais très simple d'utilisation pour construire rapidement des interfaces graphiques avec [[:python|Python]].

Le style de widgets n'est pas très esthétique (question de goût) mais ça reste tout de même une bonne base pour commencer dans le développement d'interface graphique (GUI).

===== Installation =====

[[:tutoriel:comment_installer_un_paquet|Installez les paquets]]:
  * **[[apt>python-tk]]**
  * **[[apt>python-imaging-tk]]** pour la gestion des images sous tkinter 
  * **[[apt>python3-tk]]** pour la version 3.x de python.
Ceci peut se résumer avec l'outil [[:apt-get]] en saisissant dans un [[:terminal]] les [[:commande_shell|commandes]] suivantes:
<code>sudo apt-get install python-tk
sudo apt-get install python-imaging-tk
sudo apt-get install python3-tk
</code>

===== Etude d'un programme simple =====
Pour commencer, regardez et essayer de comprendre la structure du code :

<file python>
#!/usr/bin/env python
# -*- coding: Latin-1 -*-
#
#  Programme Tkinter.py
#

from Tkinter import *  #Pour python3.x Tkinter devient tkinter

class ApplicationBasic():
	'''Application principale'''
	def __init__(self):
		'''constructeur'''
		self.fen = Tk()
		self.fen.title('Tkinter')
		
		self.bou_action = Button(self.fen)
		self.bou_action.config(text='Action', command=self.action)
		self.bou_action.pack()
		
		self.bou_quitter = Button(self.fen)
		self.bou_quitter.config(text='Quitter', command=self.fen.destroy)
		self.bou_quitter.pack()
  
		self.fen.mainloop()
		
	def action(self):
		'''Action sur un bouton'''
		self.lab = Label(self.fen)
		self.lab.config(text='Bravo!!!')
		self.lab.pack()
      
      
if __name__ == '__main__':
	app = ApplicationBasic()
</file>
chaque partie correspond à :
  * importation de la librairie : <file python>from Tkinter import *</file>
  * la création d'une classe : <file python>class ApplicationBasic():</file>
  * la création d'une méthode constructrice : <file python>def __init__(self):</file> 
  * instancier une fenêtre Tk() : <file python>self.fen = Tk()</file>
  * définition du titre de cette fenêtre : <file python>self.fen.title('Tkinter')</file>

* création d'un simple bouton action : <file python>self.bou_quitter = Button(self.fen)</file>
     * configuration de ce bouton : <file python>self.bou_action.config(text='Action', command=self.action)</file>
     * mise en place de celui-ci dans la fenêtre avec une méthode de placement : <file python>self.bou_action.pack()</file>
     * définition de la fonction qui sera connecté au bouton //Action// : <file python>
  ef action(self) :
      '''Action sur un bouton'''
      self.lab = Label(self.fen)
      self.lab.config(text='Bravo!!!')
      self.lab.pack()
</file>

* même travail pour créer un bouton quitter. Ici vous constaterez qu'il n'est pas nécessaire de créer une fonction dédiée à ce bouton, la commande associée faisant le nécessaire : <file python>self.bou_quitter = Button(self.fen)
self.bou_quitter.config(text='Quitter', command=self.fen.destroy)
self.bou_quitter.pack()</file>

* lancement du gestionnaire d'événements : <file python>self.fen.mainloop()</file>
  * assignation de la classe à une variable :<file python>app = ApplicationBasic()</file>

Enregistrer votre fichier source avec une exrenstion .py
Dans un terminal :
</code>python 'fichier.py'</code>

{{:programmetkinter.png?direct&100|Fenêtre nommée Tkinter avec les deux boutons}}          
{{:terminal:programmetkinter01.png?direct&100|Fenêtre Tkinter après appui sur le bouton //Action//}}

===== Configurer correctement sa fenêtre =====
Nous allons voir dans cette section comment bien configurer sa fenêtre selon le but recherché.
Nous prendrons comme référence les variables du programme précédent.
Voici les principales configurations les plus utilisées :
==== Titre ====

La configuration du titre de la fenêtre s'effectue trés simplement :
<file python>self.fen.title('Votre Titre')</file>

==== Dimensions ====

Pour configurer la taille :
<file python>self.fen.geometry((400x400))</file>
Le code peut varier selon la logique du développeur, nous pourions trés bien écrire :
<file python>
self.taille = (400,400)
self.fen.geometry(self.taille)
</file>
ou encore pour un petit exemple :
<file python>
self.fenwidth = 400
self.fenheight = 400
self.fen.geometry((self.fenwidth,self.fenheight))
</file>
Noter que la configuration des dimensions se fait selon le shéma: 'largeur' x 'hauteur'.
==== Placement ====

Imaginer maintenant vouloir placer une fenêtre de (400x400) centré sur votre écran.
Pour ma part je créerais une fonction gérant cela :
<file python>
self.screenwidth = self.fen.winfo_screenwidth()  #Récupération de la largeur de l'écran
self.screenheight = self.fen.winfo_screenheight()  #Récupération de la hauteur de l'écran

def geometry_fen(self) :
		'''Cette fonction est utilisée pour mettre à jour les éléments graphiques
			et créer une géométrie pour la fenêtre.'''
		self.fen.update_idletasks() #Recalcul des propriétés de la fenêtre en prenant en compte les widgets placés.
		
		self.fenwidth = 400  #Définition de la largeur de la fenêtre.
                self.fenheight = 400  #Définition de la hauteur de la fenêtre.

x = (self.screenwidth/2) - (self.fenwidth/2)  #Division par 2 de la largeur de l'écran moins la largeur de la fenêtre par 2.
		y = (self.screenheight/2) - (self.fenheight/2) #Division par 2 de la hauteur de l'écran moins la hauteur de la fenêtre par2.
		
		self.fen.geometry('%dx%d+%d+%d' % (self.fenwidth, self.fenheight, x, y))  #Définition de la géométrie de la fenêtre.
</file>
Pour appliquer la géométrie, il vous suffira de lancer cette fonction avant de lancer le gestionnaire d'événements.
==== Redimmensionnement ====

Le redimensionnement de la fenêtre, par défaut est vrai autant pour x et y. Cela veut dire que l'utilisateur peut modifier autant qu'il le souhaite la largeur comme la hauteur de la fenêtre.

Comment interdire le redimmensionnement de la fenêtre ?
<file python>
self.fen.resizable(False,False)  #Toujours suivant le même schéma : largeur, hauteur.
</file>
Est-il possible d'interdire de modifier seulement la hauteur ou la largeur ?
<file python>
self.fen.resizable(True,False) #Pour autoriser seulement le changement en x.
self.fen.resizable(False,True) #Pour autoriser seulement le changement en y.
</file>
==== Style de fenêtre ====

===== Les 4 widgets de base =====
==== Label ====

Le Label est utilisé pour afficher du texte dans la fenêtre.
==== Button ====

Un simple bouton cliquable.
==== Canvas ====

Le widget Canvas est le plus intéressant de tous les widgets présents dans la librairie.
Pourquoi? Tout simplement parce que vous pouvez pousser vos interfaces graphiques au maximum autant dans le style que dans les fonctionnalités....
Pour une construction simple et rapide d'interface en Tk(), vous utiliserez la plupart du temps les méthodes de placement (pack(), grid(), place() ), nous expliquerons ces méthodes de placement un peu plus tard.
Vous pourrez vous apercevoir que ces trois méthodes sont limitées et particulièrement linéaires.

=== Un peu de géométrie ===

=== Dessiner ===

=== Positionner des éléments ===

=== Déplacements d'éléments présents dans la Canvas ===

=== Créer des effets graphiques ===

==== Entry ====

Zone de récupération de saisies utilisateur.

==== Pour aller plus loin ====

Exemple d'un programme un peu plus complexe:

{{:capture_du_2013-02-04_00_02_19.png?direct&300|}}
===== Liens =====
  * [[http://wiki.python.org/moin/TkInter|Tkinter]] (En)
  * [[:python]]
  * [[:glade]] : pour créer des GUI facilement

----
//Contributeurs:Boileau jonathan [[boileau_jonathan@hotmail.fr]] //

Merci de recopier le code ci-contre pour prouver que vous êtes humain : B B U V J 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