Outils pour utilisateurs

Outils du site


issue197:python

Différences

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

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
issue197:python [2023/10/01 17:38] d52frissue197:python [2023/10/02 15:38] (Version actuelle) auntiee
Ligne 8: Ligne 8:
  
 Let’s take a quick look at each of these to see what benefits they give us.** Let’s take a quick look at each of these to see what benefits they give us.**
 +
 +Bonjour à nouveau, chers amis. Je viens à nouveau vers vous depuis le pays lointain du Texas central.
 +
 +Comme le titre de l'article l'indique, je vais encore parler de PAGE. Cette fois, je vais vous montrer comment pousser l'enveloppe et ajouter des widgets Tcl SANS utiliser de widget personnalisé.
 +
 +Si vous connaissez un tant soit peu PAGE, vous savez peut-être qu'il y a quelques widgets « normaux » que PAGE n'inclut pas dans sa boîte à outils. Bien que cela laisse un vide dans PAGE et son ensemble de widgets que vous pouvez utiliser, il n'y a jamais eu une grande demande de support pour ces widgets, ce qui est une des raisons pour lesquelles ils n'ont pas été ajoutés auparavant.
 +
 +De quels widgets s'agit-il ? Les widgets Menubutton et OptionMenu.
 +
 +Jetons un coup d'œil rapide à chacun d'entre eux pour voir quels avantages ils nous apportent.
  
  
Ligne 17: Ligne 27:
  
 The image above shows a very long menubutton option set that represents all of the books of the King James Bible version, grouped into the Old testament books and New testament books, split with a column break between, and each column has a “header” which is made up of a disabled menu item. Each of the menu items are Radiobutton items, which immediately return an integer value that can be looked up in the list that created the menu that represents the selection the user makes.** The image above shows a very long menubutton option set that represents all of the books of the King James Bible version, grouped into the Old testament books and New testament books, split with a column break between, and each column has a “header” which is made up of a disabled menu item. Each of the menu items are Radiobutton items, which immediately return an integer value that can be looked up in the list that created the menu that represents the selection the user makes.**
 +
 +Menubutton
 +
 +Le widget Menubutton revient à disposer d'un menu normal de type barre de menu, mais sur un bouton.
 +
 +Vous pouvez utiliser tous les éléments de menu « normaux » sur un Menubutton. Cela inclut la cascade, les commandes, les séparateurs, les boutons à cocher et les boutons radios. En outre, vous pouvez inclure des accélérateurs, des images et créer des sauts de colonne.
 +
 +L'image ci-dessus montre un très long ensemble d'options de bouton de menu qui représente tous les livres de la version King James de la Bible, regroupés en livres de l'Ancien Testament et livres du Nouveau Testament, séparés par un saut de colonne, et chaque colonne a un « en-tête » qui est composé d'un élément de menu désactivé. Chaque élément de menu est un bouton radio qui renvoie immédiatement une valeur entière qui peut être consultée dans la liste qui a créé le menu représentant la sélection effectuée par l'utilisateur.
 +
  
 **OptionMenu **OptionMenu
Ligne 29: Ligne 48:
  
 Basically there are four labels (two static and two dynamic), one button (the Exit button) and two frames. The frames are the empty boxes in between the two sets of labels. I used the “solid” relief for the frames. This way, when you are designing the form, you know exactly where the frames are. I designed the project under PAGE 7.6, so the .tcl file is included.** Basically there are four labels (two static and two dynamic), one button (the Exit button) and two frames. The frames are the empty boxes in between the two sets of labels. I used the “solid” relief for the frames. This way, when you are designing the form, you know exactly where the frames are. I designed the project under PAGE 7.6, so the .tcl file is included.**
 +
 +OptionMenu
 +
 +Le widget OptionMenu est comme un widget combobox de faible technicité.
 +
 +Lorsque vous cliquez sur le tiret sur le côté, vous obtenez un menu déroulant avec vos options.
 +
 +Le projet
 +
 +J'ai en fait créé deux projets assez similaires pour ce mois-ci, mais je ne vais passer en revue qu'un seul d'entre eux. (Vous entendez Ronnie pousser un soupir de soulagement ?) Cependant, je vais les inclure tous les deux dans le dépôt du mois. Celui que nous allons étudier ici est un projet simple qui peut être trouvé dans le dépôt sous le nom de « mb_om_demo.py ». Je ne m'étendrai pas trop sur la création du projet sous PAGE, car la façon dont je l'ai créé est assez évidente.
 +
 +En gros, il y a quatre étiquettes (deux statiques et deux dynamiques), un bouton (le bouton Exit) et deux cadres. Les cadres sont les cases vides situées entre les deux séries d'étiquettes. J'ai utilisé le relief « solid » pour les cadres. Ainsi, lorsque vous concevez le formulaire, vous savez exactement où se trouvent les cadres. J'ai conçu le projet sous PAGE 7.6 ; le fichier .tcl est donc inclus.
 +
  
 **All of the heavy work is done in the support module, so we don’t risk breaking the project by modifying the GUI module. As I always do, I inserted a line in the main function to call the startup function right before the program is shown on the screen. **All of the heavy work is done in the support module, so we don’t risk breaking the project by modifying the GUI module. As I always do, I inserted a line in the main function to call the startup function right before the program is shown on the screen.
Ligne 37: Ligne 69:
  
 This simple function just creates a list of strings that will be used to populate the Menubutton widget. While this code could easily have been included in the creation function, I decided to break it out into its own function, and to do the same thing for the items for the OptionMenu widget (below).** This simple function just creates a list of strings that will be used to populate the Menubutton widget. While this code could easily have been included in the creation function, I decided to break it out into its own function, and to do the same thing for the items for the OptionMenu widget (below).**
 +
 +Le gros du travail est entièrement fait dans le module de support ; nous ne risquons donc pas de casser le projet en modifiant le module GUI. Comme je le fais toujours, j'ai inséré une ligne dans la fonction principale pour appeler la fonction de démarrage juste avant que le programme ne soit affiché à l'écran.
 +
 +Comme vous pouvez le voir (en haut à droite), il y a deux fonctions pour chacun de nos widgets spéciaux. L'une d'elles définit les éléments que les widgets afficheront et l'autre crée le widget sur le formulaire de niveau supérieur pour nous. Il y a également deux fonctions supplémentaires, qui sont les gestionnaires de rappel.
 +
 +Nous allons donc commencer par la fonction setup_menubutton_items() (voir ci-dessous).
 +
 +Cette fonction simple crée simplement une liste de chaînes de caractères qui seront utilisées pour remplir le widget Menubutton. Alors que ce code aurait facilement pu être inclus dans la fonction de création, j'ai décidé de le séparer dans sa propre fonction, et de faire la même chose pour les éléments du widget OptionMenu (ci-dessous).
 +
  
 **One thing to notice here. The items for the Menubutton are in a list. The items for the OptionMenu is a tuple. This is important as you will see in a little bit. **One thing to notice here. The items for the Menubutton are in a list. The items for the OptionMenu is a tuple. This is important as you will see in a little bit.
Ligne 44: Ligne 85:
 The first thing we do to create the Menubutton widget is to define a couple of global variables, one for the carTypes, which we just defined in the setup_menubutton_items function, and the other named selection, which will be a type of tk.IntVar, since our menu items will all be of the radiobutton type. Then we set the frame relief from solid to flat, to make the frame invisible. Finally, we make the actual assignment of the tk.IntVar. Again, we will do this so the user’s selection will immediately be handled and to cut down on the number of callback functions. The first thing we do to create the Menubutton widget is to define a couple of global variables, one for the carTypes, which we just defined in the setup_menubutton_items function, and the other named selection, which will be a type of tk.IntVar, since our menu items will all be of the radiobutton type. Then we set the frame relief from solid to flat, to make the frame invisible. Finally, we make the actual assignment of the tk.IntVar. Again, we will do this so the user’s selection will immediately be handled and to cut down on the number of callback functions.
  
-Next, we create the actual widget. Then we will use the Pack geometry manager to “shove” the widget into the frame and force it to completely fill the frame. The name of the MenuButton instance is mnuBtn. We’ll use this every time we need to reference it. Notice that we don’t use the normal _w1. prefix, since we created this not PAGE.+Next, we create the actual widget. Then we will use the Pack geometry manager to “shove” the widget into the frame and force it to completely fill the frame. The name of the Menubutton instance is mnuBtn. We’ll use this every time we need to reference it. Notice that we don’t use the normal _w1. prefix, since we created this not PAGE.
  
     mnuBtn = ttk.Menubutton(_w1.mbFrame, text="Items")     mnuBtn = ttk.Menubutton(_w1.mbFrame, text="Items")
  
     mnuBtn.pack(expand=True, side="top", fill="both", anchor="nw")**     mnuBtn.pack(expand=True, side="top", fill="both", anchor="nw")**
 +
 +Une chose à noter ici. Les éléments du Menubutton sont dans une liste. Les éléments de l'OptionMenu sont des tuple. C'est important, comme vous le verrez dans quelques instants.
 +
 +Nous allons maintenant créer le widget Menubutton et le placer dans le cadre approprié (ci-dessous).
 +
 +La première chose à faire pour créer le widget Menubutton est de définir quelques variables globales, l'une pour les carTypes, que nous venons de définir dans la fonction setup_menubutton_items, et l'autre nommée selection, qui sera un type de tk.IntVar, puisque nos éléments de menu seront tous de type radiobutton. Ensuite, nous définissons le relief du cadre de solid à flat, pour rendre le cadre invisible. Enfin, nous procédons à l'affectation réelle de tk.IntVar. Encore une fois, nous faisons cela pour que la sélection de l'utilisateur soit immédiatement traitéé et pour réduire le nombre de fonctions de rappel.
 +
 +Ensuite, nous créons le widget proprement dit. Nous utiliserons ensuite le gestionnaire de géométrie Pack pour « pousser » le widget dans le cadre et le forcer à remplir le frame complètement. Le nom de l'instance du Menubutton est mnuBtn. Nous l'utiliserons chaque fois que nous devrons y faire référence. Notez que nous n'utilisons pas le préfixe normal _w1. puisque nous l'avons créé en dehors de PAGE.
 +
 +    mnuBtn = ttk.Menubutton(_w1.mbFrame, text="Items")
 +
 +    mnuBtn.pack(expand=True, side="top", fill="both", anchor="nw")
 +
  
 **Now (top right) we have to define the menu object that will be attached to the menu button. **Now (top right) we have to define the menu object that will be attached to the menu button.
Ligne 61: Ligne 115:
  
 Finally, we do the creation of the instance of the OptionMenu button and finally pack the widget into its frame, just like we did with the Menubutton widget.** Finally, we do the creation of the instance of the OptionMenu button and finally pack the widget into its frame, just like we did with the Menubutton widget.**
 +
 +Maintenant (en haut à droite), nous devons définir l'objet menu qui sera attaché au bouton de menu.
 +
 +La dernière chose que nous faisons pour le Menubutton est de définir une variable compteur, de parcourir la liste des carTypes, puis de créer l'élément de menu radiobutton avec le nom du type de voiture, le rappel, la valeur de la variable compteur que nous définissons comme la valeur qui sera transmise au rappel, et le nom de la variable qui, dans notre cas, est la sélection. Enfin, en bas à droite, nous ajoutons un à la variable counter.
 +
 +Nous commençons par le même type de code que pour le widget Menubutton. Nous définissons les globales, nous définissons le relief du cadre de solid à flat, et nous définissons tk.StringVar pour notre valeur de retour.
 +
 +La ligne suivante n'est techniquement pas nécessaire, puisqu'elle définit la portion d'affichage de l'OptionMenu à « Options ». Si nous ne faisons pas cela, le menu n'affichera rien.
 +
 +    returnval.set("Options")
 +
 +Enfin, nous créons l'instance du bouton OptionMenu et nous plaçons le widget dans son cadre, comme nous l'avons fait pour le widget Menubutton.
 +
  
 **However, notice that in the options for the widget, we use *optionlist as the “list” of options to display. Remember that I said we need to make this a tuple, not a list. The reason for this is that you can provide each item separately as the syntax line below shows… **However, notice that in the options for the widget, we use *optionlist as the “list” of options to display. Remember that I said we need to make this a tuple, not a list. The reason for this is that you can provide each item separately as the syntax line below shows…
Ligne 68: Ligne 135:
 If we were to use a straight list, the options will all be placed on the same line instead of a dropdown set of items. There might be a reason for you to want to do this, but I can’t imagine one (next page). If we were to use a straight list, the options will all be placed on the same line instead of a dropdown set of items. There might be a reason for you to want to do this, but I can’t imagine one (next page).
  
-That’s it. Now I have to say that the OptionMenu widget is REALLY a whole lot easier to deal with than the MenuButton. If you’ve ever created a menu by hand in Tkinter, you know it is not a painless process and often not worth all the work. You can see what I mean in the second project. If you run back to the first image in the article, you will see the Menubutton example. I really did this as a proof of concept more than for any real need. I would probably use a popup menu created in the PAGE menu editor before I would hand code a menu for a Menubutton.**+That’s it. Now I have to say that the OptionMenu widget is REALLY a whole lot easier to deal with than the Menubutton. If you’ve ever created a menu by hand in Tkinter, you know it is not a painless process and often not worth all the work. You can see what I mean in the second project. If you run back to the first image in the article, you will see the Menubutton example. I really did this as a proof of concept more than for any real need. I would probably use a popup menu created in the PAGE menu editor before I would hand code a menu for a Menubutton.** 
 + 
 +Cependant, remarquez que dans les options du widget, nous utilisons *optionlist comme la « liste » d'options à afficher. Rappelez-vous que j'ai dit que nous devions en faire un tuple, et non une liste. La raison en est que vous pouvez fournir chaque élément séparément, comme le montre la ligne de syntaxe ci-dessous... 
 + 
 +w = ttk.OptionMenu(parent, variable, choix 1 , choix 2 , ...) 
 + 
 +Si nous devions utiliser une véritable liste, les options seraient toutes placées sur la même ligne au lieu d'un ensemble d'éléments déroulants. Vous pourriez avoir une raison de vouloir faire cela, mais je n'en vois pas (page suivante). 
 + 
 +Voilà, c'est fait. Je dois dire que le widget OptionMenu est VRAIMENT beaucoup plus facile à utiliser que Menubutton. Si vous avez déjà créé un menu à la main dans Tkinter, vous savez que ce n'est pas un processus sans douleur et qu'il ne vaut souvent pas la peine d'y consacrer tout son temps. Vous pouvez voir ce que je veux dire dans le deuxième projet. Si vous revenez à la première image de l'article, vous verrez l'exemple du Menubutton. J'ai vraiment fait cela comme une preuve de concept plus que pour un besoin réel. J'utiliserais probablement un menu contextuel créé dans l'éditeur de menu PAGE avant de coder à la main un menu pour un Menubutton. 
  
 **The whole purpose in this project was to show you that with a little work (well, a LOT of work in the case of the Menubutton) and digging, you can use any widget that Tkinter provides even if PAGE doesn’t support it. **The whole purpose in this project was to show you that with a little work (well, a LOT of work in the case of the Menubutton) and digging, you can use any widget that Tkinter provides even if PAGE doesn’t support it.
Ligne 75: Ligne 151:
  
 Until next time, as always; stay safe, healthy, positive and creative!** Until next time, as always; stay safe, healthy, positive and creative!**
 +
 +Le but de ce projet était de vous montrer qu'avec un peu de travail (enfin, BEAUCOUP de travail dans le cas du Menubutton) et en creusant, vous pouvez utiliser n'importe quel widget fourni par Tkinter même si PAGE ne le prend pas en charge.
 +
 +J'ai mis le code du projet de ce mois-ci dans un dépôt github à https://github.com/gregwa1953/FCM-197.
 +
 +Jusqu'à la prochaine fois, comme toujours, restez en sécurité, en bonne santé, positifs et créatifs !
 +
issue197/python.1696174735.txt.gz · Dernière modification : 2023/10/01 17:38 de d52fr