Différences

Ci-dessous, les différences entre deux révisions de la page.

--- 59:tuto_python [2012/04/10 19:24] – fredphil91
+++ 59:tuto_python [2012/05/01 14:26] (Version actuelle) – kai23
@@ Ligne 9: / Ligne 9: @@
 Après notre dernière rencontre, vous devriez avoir une assez bonne idée de la façon d'utiliser Page. Sinon allez vite lire l'article du mois dernier. Nous allons continuer cette fois-ci en créant une application de liste de fichiers avec une interface graphique. Le but ici est de créer une application graphique qui va récursivement parcourir un répertoire, en cherchant des fichiers avec un ensemble défini d'extensions, et afficher le résultat dans une vue arborescente. Pour cet exemple, nous allons chercher les fichiers multimédias avec les extensions .avi, .mkv, .mv4, .mp3 et .ogg.
-Cette fois, le texte peut sembler un peu laconique dans la partie conception. Tout ce que je vais faire, c'est vous donner des indications pour le placement des widgets ainsi que les attributs et les valeurs requises de cette façon...
+Cette fois, le texte peut sembler un peu laconique dans la partie conception. Tout ce que je vais faire, c'est vous donner des indications pour le placement des widgets, ainsi que les attributs et les valeurs requises, de cette façon...
 Widget
@@ Ligne 26: / Ligne 26: @@
 Title: Searcher**
-Je ne mettrai les chaînes entre guillemets que lorsque cela sera nécessaire. Par exemple, pour l'un des boutons, le texte doit être réglé sur « ... ».
+Je ne citerai les chaînes de texte que lorsque cela sera nécessaire. Par exemple, pour l'un des boutons, le texte doit être réglé sur « ... ».
 Voici à quoi va ressembler l'interface graphique de notre application...
@@ Ligne 53: / Ligne 53: @@
 Move this close to the center of the frame or close to the frame's right side. I set mine to X 530 and Y 10.**
-Assurez-vous de sauvegarder souvent. Lorsque vous enregistrez le fichier, donnez-lui le nom « Rechercher ». Rappelez-vous, Page ajoute l'extension .tcl pour vous et quand vous générerez le code python il sera sauvegardé dans le même dossier.
+Assurez-vous de sauvegarder souvent. Lorsque vous enregistrez le fichier, donnez-lui le nom « Rechercher ». Rappelez-vous, Page ajoute l'extension .tcl à votre place et quand vous générerez le code python il sera sauvegardé dans le même dossier.
-Ensuite, ajoutez un cadre. Il devrait se placer tout en haut du cadre principal. Définissez les attributs comme suit.
+Ensuite, ajoutez un cadre. Il devrait se placer tout en haut du cadre principal. Définissez les attributs comme suit :
 Largeur : 595
@@ Ligne 64: / Ligne 64: @@
 Dans ce cadre, ajoutez un bouton. Ce sera notre bouton Quitter.
-Alias : btnExit
+Alias : btnQuitter
 Texte : Quitter
@@ Ligne 120: / Ligne 120: @@
 Alias : btnCheminRecherche
-Texte : « ... » (sans guillemets)
+Texte : « ... » (sans guillemets).
-Ajoutez cinq (5) cases à cocher. Mettez-les dans l'ordre suivant...
+Ajoutez cinq (5) cases à cocher. Mettez-les dans l'ordre suivant :
@@ Ligne 193: / Ligne 193: @@
 Texte : ALLER !
-Maintenant, ajoutez un autre cadre en-dessous du précédent.
+Maintenant, ajoutez un autre cadre en dessous du précédent.
 Largeur : 565
@@ Ligne 217: / Ligne 217: @@
 Voilà. Nous avons conçu notre interface graphique. Maintenant tout ce qu'il reste à faire est de créer notre liste de fonctions et de lier ces fonctions à nos boutons.
-Dans la fenêtre de liste des fonctions, cliquez sur le bouton Nouveau (le bouton le plus à gauche). Ceci nous amène à l'éditeur de nouvelle fonction. Modifiez le texte dans la zone de saisie Fonction en remplaçant « py: xxx » par « py: btnClicQuitter()". Dans la zone de texte de l'argument saisissez « p1 ». Dans la zone de saisie multilignes du bas, changez le texte en :
+Dans la fenêtre de liste des fonctions, cliquez sur le bouton Nouveau (le bouton le plus à gauche). Ceci nous amène à l'éditeur de nouvelle fonction. Modifiez le texte dans la zone de saisie Fonction en remplaçant « py: xxx » par « py: btnClicQuitter() ». Dans la zone de texte de l'argument saisissez « p1 ». Dans la zone de saisie multilignes du bas, changez le texte en :
 def btnClicQuitter(p1):
@@ Ligne 241: / Ligne 241: @@
 Enfin, ajoutez une autre fonction appelée « btnCheminRecherche ». Encore une fois, laissez l'instruction « pass ».
-Enfin, nous devons relier les boutons et les fonctions que nous venons de créer.
+En tout dernier lieu, nous devons relier les boutons et les fonctions que nous venons de créer.
-Faites un clic droit sur le bouton Quitter que nous avons créé, sélectionnez Lier. Une grande boîte apparaîtra. Cliquez sur le bouton Nouvelle liaison, cliquer sur bouton-1 et remplacez le mot « A FAIRE » dans la boîte de saisie de texte de droite par « btnClicQuitter ». NE METTEZ PAS les parenthèses () ici.
+Faites un clic droit sur le bouton Quitter que nous avons créé, sélectionnez Lier. Une grande boîte apparaîtra. Cliquez sur le bouton Nouvelle liaison, cliquez sur bouton-1 et remplacez le mot « A FAIRE » dans la boîte de saisie de texte de droite par « btnClicQuitter ». NE METTEZ PAS les parenthèses () ici.
 Liez le bouton ALLER à la fonction btnClicAller et le bouton « ... » à btnClicCheminRecherche.
@@ Ligne 249: / Ligne 249: @@
 Sauvegardez votre interface graphique et générez le code python.
-Now all we have left is to create the code that “glues” the GUI together.
+**Now all we have left is to create the code that “glues” the GUI together.
 Open up the code we just generated in your favorite editor. Let's start off by examining what Page created for us.
@@ Ligne 257: / Ligne 257: @@
 We'll be modifying the 2.x code portion to import other tkinter modules in a few moments.
-Next is the “vp_start_gui()” routine. This is the program's main routine. This sets up our gui, sets the variables we need, and then calls the tkinter main loop. You might notice the line “w = None” below this. It is not indented and it isn't supposed to be.
+Next is the “vp_start_gui()” routine. This is the program's main routine. This sets up our gui, sets the variables we need, and then calls the tkinter main loop. You might notice the line “w = None” below this. It is not indented and it isn't supposed to be.**
-Next are two routines (create_Searcher and destroy_Searcher) that are used to replace the main loop routine if we are calling this application as a library. We don't need to worry about these.
+Maintenant tout ce qu'il reste à faire est de créer le code qui « agglutine » l'interface graphique.
+Ouvrez le code que nous venons de générer dans votre éditeur de texte favori. Commençons par examiner ce que Page a créé pour nous.
+Au début du fichier se trouve l'en-tête standard python et une déclaration d'importation unique pour importer la bibliothèque système (sys). Ensuite vient du code plutôt confus (à première vue). C'est simplement pour examiner la version de python avec laquelle vous essayez d'exécuter l'application, puis pour importer les versions correctes des bibliothèques Tkinter. À moins que vous n'utilisiez Python 3.x, vous pouvez tout simplement ignorer les deux derniers.
+Nous allons modifier la portion de code 2.x dans quelques instants pour importer d'autres modules Tkinter.
+Arrive ensuite la routine « vp_start_gui() ». C'est la routine principale du programme. Ceci met en place notre interface, définit les variables dont nous avons besoin et appelle ensuite la boucle principale Tkinter. Vous remarquerez peut-être la ligne « w = None » juste en dessous. Elle n'est pas indentée et n'a pas besoin de l'être.
+**Next are two routines (create_Searcher and destroy_Searcher) that are used to replace the main loop routine if we are calling this application as a library. We don't need to worry about these.
 Next is the “set_Tk_var” routine. We define the tkinter variables used that need to be set up before we create the widgets. You might recognize these as the text variable for the FilePath entry widget and the variables for our check boxes. The next three routines here are the functions we created using the function editor and an “init()” function.
@@ Ligne 265: / Ligne 275: @@
 Run the program now. Notice that the check buttons have grayed out checks in them. We don't want that in our “release” app, so we'll create some code to clear them before the form is displayed to the user. The only functioning thing other than the check boxes is the Exit button.
-Go ahead and end the program.
+Go ahead and end the program.**
+Ensuite viennent deux routines (create_Rechercher et destroy_Rechercher) qui sont utilisées pour remplacer la routine principale si nous utilisons cette application comme une bibliothèque. Nous n'avons pas besoin de nous inquiéter à ce sujet.
+Arrive ensuite la routine « initialise_var_Tk ». Nous définissons les variables Tkinter utilisées qui doivent être mises en place avant de créer les widgets. Vous pouvez sans doute reconnaître la variable texte pour le widget de saisie CheminFichier et les variables de nos cases à cocher. Les trois routines suivantes sont les fonctions que nous avons créées en utilisant l'éditeur de fonctions et une fonction « init() ».
+Exécutez le programme maintenant. Notez que les cases à cocher contiennent des coches grisées. Nous ne voulons pas cela dans notre application finale, nous allons donc créer un peu de code pour les faire disparaître avant que le formulaire ne soit affiché à l'utilisateur. La seule chose qui fonctionne à part les cases à cocher est le bouton Quitter.
+Utilisez-le pour terminer le programme.
-Now, we'll take a look at the class that actually holds the GUI definition. That would be “class Searcher”. Here is where all the widgets are defined and placed in our form. You should be familiar with this by now.
+**Now, we'll take a look at the class that actually holds the GUI definition. That would be “class Searcher”. Here is where all the widgets are defined and placed in our form. You should be familiar with this by now.
 Two more classes are created for us that hold the code to support the scrolled tree view. We don't have to change any of this. It was all created by Page for us.
@@ Ligne 274: / Ligne 292: @@
 We need to import a few more library modules, so under the “import sys” statement, add...
+import os
+from os.path import join, getsize, exists**
+Maintenant, nous allons jeter un coup d'oeil à la classe qui contient effectivement la définition de l'interface graphique. Il s'agit de la classe « Chercheur ». C'est là que tous les widgets sont définis et placés dans notre formulaire. Vous devez être familier avec cela maintenant.
+Deux classes de plus sont créées, elles contiennent le code pour gérer l'arborescence qui défile. Nous n'avons pas à changer tout cela. Tout a été créé pour nous par Page.
+Revenons maintenant au début du code et commençons à le modifier.
+Nous avons besoin d'importer quelques modules de bibliothèque de plus ; pour cela ajoutez en dessous de la déclaration « import sys » :
 import os
@@ Ligne 279: / Ligne 309: @@
 from os.path import join, getsize, exists
-Now find the section that has the line “py2 = True”. As we said before, this is the section that deals with the tkinter imports for Python version 2.x. Below the “import ttk”, we need to add the following to support the FileDialog library. We also need to import the tkFont module.
+**Now find the section that has the line “py2 = True”. As we said before, this is the section that deals with the tkinter imports for Python version 2.x. Below the “import ttk”, we need to add the following to support the FileDialog library. We also need to import the tkFont module.
 import tkFileDialog
@@ Ligne 291: / Ligne 321: @@
 exts = []
-FileList=[]
+FileList=[]**
-Here we create two global variables (exts and FileList) that will be accessed later on in our code. Both are lists. “exts” is a list of the extensions that the user selects from the GUI. “FileList" holds a list of lists of the matching files found when we do our search. We'll use that to populate the treeview widget.
+Maintenant, trouvez la section qui contient la ligne « py2 = True ». Comme nous l'avons dit, c'est la section qui traite des importations tkinter pour Python version 2.x. En dessous de « import ttk », nous avons besoin d'ajouter ce qui suit pour utiliser la bibliothèque FileDialog. Nous avons également besoin d'importer le module tkFont.
+import tkFileDialog
+import tkFont
+Ensuite nous devons ajouter quelques variables à la routine « initialise_var_Tk() ». En bas de la routine, ajoutez les lignes suivantes :
+global exts, FileList
+exts = []
+ListeFichiers=[]
+**Here we create two global variables (exts and FileList) that will be accessed later on in our code. Both are lists. “exts” is a list of the extensions that the user selects from the GUI. “FileList" holds a list of lists of the matching files found when we do our search. We'll use that to populate the treeview widget.
 Since our “btnExitClick” is already done for us by Page, we'll deal with the “btnGoClick” routine. Comment out the pass statement and add the code so it looks like this...
@@ Ligne 309: / Ligne 353: @@
 Walkit(fp,e1)
-LoadDataGrid()
+LoadDataGrid()**
-This is the routine that will be called when the user clicks the “GO!” button. We call a routine called “BuildExts” which creates the list of the extensions that the user has selected. Then we get the path that the user has selected from the AskDirectory dialog and assign that to the fp variable. We then create a tuple from the extension list, which is needed when we check for files. We then call a routine called “Walkit”, passing the target directory and the extension tuple.
+Ici, nous créons deux variables globales (exts et ListeFichiers) qui seront utilisées plus tard dans notre code. Les deux sont des listes. « exts » est une liste des extensions que l'utilisateur sélectionne dans l'interface. « ListeFichiers » contient une liste des fichiers correspondants à la recherche effectuée par l'utilisateur. Nous allons l'utiliser pour remplir le widget de vue arborescente.
+Puisque notre « btnClicQuitter » est déjà créé pour nous par Page, nous allons nous occuper de la routine « btnClicAller ». Commentez la déclaration pass et ajoutez le code de sorte qu'il ressemble à ceci :
+def btnClicAller(p1) :
+#pass
+ConstruireExts()
+chemin = CheminFichier.get()
+e1 = tuple(exts)
+Parcourir(chemin,e1)
+ChargerDonnees()
+**This is the routine that will be called when the user clicks the “GO!” button. We call a routine called “BuildExts” which creates the list of the extensions that the user has selected. Then we get the path that the user has selected from the AskDirectory dialog and assign that to the fp variable. We then create a tuple from the extension list, which is needed when we check for files. We then call a routine called “Walkit”, passing the target directory and the extension tuple.
 Finally we call a routine called “LoadDataGrid”.
@@ Ligne 323: / Ligne 385: @@
      path = tkFileDialog.askdirectory() #**self.file_opt)
-     FilePath.set(path)
+     FilePath.set(path)**
-The init routine is next. Again, make the code look like this...
+C'est la routine qui est appelée lorsque l'utilisateur clique sur le bouton « ALLER ! ». Nous appelons une routine appelée « ConstruireExts » qui crée la liste des extensions que l'utilisateur a sélectionnée. Puis nous récupérons le chemin que l'utilisateur a choisi dans la boîte de dialogue de demande de répertoire et l'assignons à la variable chemin. Nous créons ensuite un tuple à partir de la liste des extensions, ce qui est nécessaire quand nous vérifions les fichiers. Nous appelons ensuite une routine appelée « Parcourir » en lui passant le répertoire cible et le tuple des extensions.
+Enfin, nous appelons une routine nommée « ChargerDonnees ».
+Ensuite, nous devons étoffer la routine « btnClicCheminRecherche ». Commentez la déclaration pass et modifiez le code pour qu'il ressemble à ceci :
+def btnClicCheminRecherche(p1) :
+     #pass
+     chemin = tkFileDialog.askdirectory() #**self.file_opt)
+     CheminFichier.set(chemin)
+**The init routine is next. Again, make the code look like this...
 def init():
@@ Ligne 339: / Ligne 415: @@
      treeview = w.Scrolledtreeview1
-     SetupTreeview()
+     SetupTreeview()**
-Here we create a global called “treeview”. We then call a routine that will clear the gray checks from the check boxes, assign the “treeview” variable to point to the Scrolled treeview in our form and call “SetupTreeview” to set the headers for the columns.
+Puis vient la routine init. À nouveau, le code doit ressembler à ceci :
+def init():
+     #pass
+     # se lance apres la creation des fenetres et des widgets...
+     global VueArborescente
+     InitialiserCases()
+     VueArborescente = w.Scrolledtreeview1
+     InitialiserVueArborescente()
+**Here we create a global called “treeview”. We then call a routine that will clear the gray checks from the check boxes, assign the “treeview” variable to point to the Scrolled treeview in our form and call “SetupTreeview” to set the headers for the columns.
 Here's the code for the BlankChecks routine which needs to be next.
 def BlankChecks():
+     VchkAVI.set('0')
+     VchkMKV.set('0')
+     VchkMP3.set('0')
+     VchkMV4.set('0')
+     VchkOGG.set('0')**
+Ici, nous créons une variable globale appelée VueArborescente. Nous appelons ensuite une routine qui efface les contrôles gris dans les cases à cocher, affectons la variable VueArborescente pour pointer vers l'arborescence avec ascenseurs de notre formulaire et appelons InitialiserVueArborescente pour définir les en-têtes pour les colonnes.
+Voici le code de la routine InitialiserCases qui doit être la suivante :
+def InitialiserCases():
      VchkAVI.set('0')
@@ Ligne 356: / Ligne 463: @@
      VchkOGG.set('0')
-Here, all we are doing is setting the variables (which automatically sets the check state in our check boxes) to “0”. If you remember, whenever the check box is clicked, this variable is automatically updated. If the variable is changed by our code, the check box responds as well. Now (above right) we'll deal with the routine that builds the list of extensions from what the user has clicked.
+**Here, all we are doing is setting the variables (which automatically sets the check state in our check boxes) to “0”. If you remember, whenever the check box is clicked, this variable is automatically updated. If the variable is changed by our code, the check box responds as well. Now (above right) we'll deal with the routine that builds the list of extensions from what the user has clicked.
 Cast your memory back to my ninth article in FCM#35. We wrote some code to create a catalog of MP3 files. We'll use a shortened version of that routine (middle right). Refer back to FCM#35 if you have questions about this routine.
-Next (bottom right) we call the SetupTreeview routine. It's fairly straightforward. We define a variable “ColHeads” with the headings we want in each column of the treeview. We do this as a list. We then set the heading attribute for each column. We also set the column width to the size of this header.
+Next (bottom right) we call the SetupTreeview routine. It's fairly straightforward. We define a variable “ColHeads” with the headings we want in each column of the treeview. We do this as a list. We then set the heading attribute for each column. We also set the column width to the size of this header.**
-Finally we have to create the “LoadDataGrid” routine (next page, top right) which is where we load our data into the treeview. Each row of the treeview is one entry in the FileList list variable. We also adjust the width of each column (again) to match the size of the column data.
+Ici, tout ce que nous faisons, c'est de définir les variables (ce qui définit automatiquement l'état d'activation dans nos cases à cocher) à 0. Si vous vous souvenez, à chaque fois qu'on clique sur la case, cette variable est automatiquement mise à jour. Si la variable est modifiée par notre code, la case à cocher répond également. Maintenant (en haut à droite) nous allons nous occuper de la routine qui établit la liste des extensions à partir de ce que l'utilisateur a cliqué.
+Essayez de vous rappeler mon neuvième article dans le FCM n° 35. Nous avions écrit du code pour créer un catalogue de fichiers MP3. Nous allons utiliser une version abrégée de cette routine (au milieu à droite). Reportez-vous au FCM n°35 si vous avez des questions au sujet de cette routine.
+Ensuite (en bas à droite) nous appelons la routine InitialiserVueArborescente. C'est assez simple. Nous définissons une variable « TitresColonnes » avec les rubriques que nous voulons dans chaque colonne de l'arborescence. Nous utilisons une liste pour cela. Nous réglons ensuite l'attribut titre de chaque colonne. Nous réglons également la largeur de colonne à la taille de cet en-tête.
+**Finally we have to create the “LoadDataGrid” routine (next page, top right) which is where we load our data into the treeview. Each row of the treeview is one entry in the FileList list variable. We also adjust the width of each column (again) to match the size of the column data.
 That's it for the first blush of the application. Give it a run and see how we did. Notice that if you have a large number of files to go through, the program looks like it's not responding. This is something that needs to be fixed. We'll create routines to change our cursor from the default to a “watch” style cursor and back so when we do something that takes a long time, the user will notice.
@@ Ligne 374: / Ligne 487: @@
 preBusyCursors = None
-busyWidgets = (root, )
+busyWidgets = (root, )**
-What we do here is set up global variables, assign them and then we set the widget(s) (in busyWidgets) we wish to respond to the cursor change. In this case we set it to root which is our full window. Notice that this is a tuple.
+Enfin, nous devons créer la routine « ChargerDonnees » (page suivante, en haut à droite) qui est l'endroit où nous chargeons nos données dans l'arborescence. Chaque ligne de l'arborescence est une entrée dans la variable de type liste ListeFichiers. Nous devons également ajuster la largeur de chaque colonne (à nouveau) pour correspondre à la taille des données de la colonne.
+C'est tout pour la première vue de l'application. Exécutez-la et voyez ce que ça fait. Notez que si vous avez un grand nombre de fichiers à parcourir, vous aurez l'impression que le programme ne répond pas. C'est quelque chose qui doit être corrigé. Nous allons créer des routines pour modifier notre curseur de la valeur par défaut à un curseur en forme de montre et vice-versa pour que l'utilisateur soit au courant quand nous faisons quelque chose qui prend beaucoup de temps.
+Dans la routine « initialise_var_Tk », ajoutez le code suivant à la fin.
+global CurseurOccupe,CurseursPresqueOccupe,WidgetsOccupes
+CurseurOccupe = 'watch'
+CurseursPresqueOccupes = None
+WidgetsOccupes = (racine, )
+**What we do here is set up global variables, assign them and then we set the widget(s) (in busyWidgets) we wish to respond to the cursor change. In this case we set it to root which is our full window. Notice that this is a tuple.
 Next we create two routines to set and unset the cursor. First the set routine, which we will call “busyStart”. After our “LoadDataGrid” routine, insert the code shown middle right.
@@ Ligne 384: / Ligne 511: @@
 Now put the code shown bottom right below it.
-In this routine, we basically reset the cursor for the widgets in our busyWidget tuple back to our default cursor.
+In this routine, we basically reset the cursor for the widgets in our busyWidget tuple back to our default cursor.**
-Save and run your program. You should find that the cursor changes whenever you have a long list of files to go through.
+Ici, nous mettons en place des variables globales, nous les initialisons, puis nous réglons le(s) widget(s) (dans WidgetsOccupes) pour lesquels nous souhaitons gérer le changement de curseur. Dans ce cas, nous avons mis racine qui est notre fenêtre entière. Remarquez que c'est un tuple.
+Ensuite, nous créons deux routines pour modifier et remettre le curseur. D'abord la routine qui modifie, que nous appelons « DebutOccupation ». Insérez le code que vous voyez au milieu à droite après la routine « ChargerDonnees ».
+Nous vérifions d'abord si une valeur a été passée à « nouveaucurseur ». Sinon, nous mettons par défaut CurseurOccupe. Puis nous parcourons le tuple WidgetsOccupes et réglons le curseur sur ce que nous voulons.
+Maintenant, mettez le code que vous voyez en bas juste en dessous.
+Dans cette routine, nous réinitialisons simplement le curseur pour les widgets dans notre tuple WidgetsOccupes à notre curseur par défaut.
+**Save and run your program. You should find that the cursor changes whenever you have a long list of files to go through.
 While this application doesn't really do much but show you how to use Page to create really fast code development. From today's article, you can see how having a good design of your GUI ahead of time can make the development process easy and fairly painless.
@@ Ligne 392: / Ligne 529: @@
 The tcl file is saved in pastebin at http://pastebin.com/AA1kE4Dy and the python code is saved at http://pastebin.com/VZm5un3e.
-See you next time.
+See you next time.**
+Enregistrez et exécutez votre programme. Vous devrez voir que le curseur change chaque fois que vous avez une longue liste de fichiers à parcourir.
+Cette application ne fait pas vraiment grand chose, mais elle vous a montré comment utiliser Page pour développer très rapidement. Avec l'article d'aujourd'hui, vous pouvez voir qu'une bonne conception de votre interface graphique à l'avance peut rendre le processus de développement facile et relativement indolore.
+Le fichier tcl est enregistré sur pastebin : http://pastebin.com/AA1kE4Dy (en anglais) et le code Python est enregistré ici : http://pastebin.com/WYK2SKQj.
+Rendez-vous la prochaine fois.