Hello again, fellow Beings. I come again to you from the remote land of Central Texas. As the article title suggests, I’m going to be talking about PAGE again. This time, I will show you how to push the envelope and add Tcl widgets WITHOUT using a Custom widget. If you are at all familiar with PAGE, you might know that there are a couple of “normal” widgets that PAGE doesn’t include in its toolbox. While that leaves a gap in PAGE and its set of widgets that you can use, there has never been a great request for support for those widgets, which is one reason they haven’t been added before now. What widgets would I be talking about? The Menubutton and the OptionMenu widgets. 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.
Menubutton The Menubutton widget is like having a normal menubar-type menu but on a button. You can use all the “normal” menu items on a Menubutton. This includes cascade, command, separators, checkbuttons, and radiobuttons. In addition, you can include accelerators, images, and create column breaks. 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 The OptionMenu widget is like a low-tech combobox widget. When you click on the dash on the side, you get a dropdown with your options. The Project I actually created two fairly similar projects for this month, but I’m going to go over only one of them. (Could you hear Ronnie give out a sigh of relief there?) However, I’m going to include them both in the repository for this month. The one we will look at here is a simple project that can be found in the repository under the name of “mb_om_demo.py”. I won’t go too deep into the creation of the project under PAGE, since it will be fairly obvious how I created it. 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. As you can see (top right) there are two functions for each of our special widgets. One that sets up the items that the widgets will show, and one that actually creates the widget on the toplevel form for us. There are also two additional functions, which are the callback handlers. So, we’ll start with the setup_menubutton_items() function (bottom 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. Now we will create the Menubutton widget and stick it into the proper Frame(below). 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. mnuBtn = ttk.Menubutton(_w1.mbFrame, text=“Items”) 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. The last thing we do for the Menubutton is to define a counter variable, and walk through the list of carTypes, and then create the radiobutton menu item with the name of the car type, the callback, the value of the counter variable which we set as the value that will be passed back to the callback, and the name of the variable which in our case is selection. Finally, bottom right, we add one to the counter variable. We start off with the same kind of code we did for the Menubutton widget. Define the globals, set the relief for the frame from solid to flat, and define the tk.StringVar for our return value. The next line is technically not needed, since it sets the display portion of the OptionMenu to “Options”. If we don’t do that, it just won’t display anything. returnval.set(“Options”) 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… w = ttk.OptionMenu(parent, variable, choice 1 , choice 2 , …) 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.
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. I’ve put the code for this month’s project in a github repository at https://github.com/gregwa1953/FCM-197. 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 !