Table of Contents There are two ways to create menus: there's the easy way, and there's the hard way. Both have their uses, but you can usually use the ItemFactory (the easy way). The "hard" way is to create all the menus using the calls directly. The easy way is to use the gtk.ItemFactory calls. This is much simpler, but there are advantages and disadvantages to each approach. NoteIn PyGTK 2.4 ItemFactory is deprecated - use the UIManager instead. The ItemFactory is much easier to use, and to add new menus to, although writing a few wrapper functions to create menus using the manual method could go a long way towards usability. With the Itemfactory, it is not possible to add images or the character '/' to the menus. In the true tradition of teaching, we'll show you the hard way first. :) There are three widgets that go into making a menubar and submenus:
This is slightly complicated by the fact that menu item widgets are used for two different things. They are both the widgets that are packed into the menu, and the widget that is packed into the menubar, which, when selected, activates the menu. Let's look at the functions that are used to create menus and menubars. This first function is used to create a new menubar:
This rather self explanatory function creates a new menubar. You use the gtk.Container add() method to pack this into a window, or the gtk.Box pack methods to pack it into a box - the same as buttons.
This function returns a reference to a new menu; it is never actually shown (with the show() method), it is just a container for the menu items. I hope this will become more clear when you look at the example below. The next function is used to create menu items that are packed into the menu (and menubar):
The label, if any, will be parsed for mnemonic characters. This call is used to create the menu items that are to be displayed. Remember to differentiate between a "menu" as created with gtk.Menu() and a "menu item" as created by the gtk.MenuItem() functions. The menu item will be an actual button with an associated action, whereas a menu will be a container holding menu items. Once you've created a menu item you have to put it into a menu. This is done using the append() method. In order to capture when the item is selected by the user, we need to connect to the "activate" signal in the usual way. So, if we wanted to create a standard menu, with the options , Quit, the code would look something like:
At this point we have our menu. Now we need to create a menubar and a menu item for the entry, to which we add our menu. The code looks like this:
Now we need to associate the menu with file_item. This is done with the method:
So, our example would continue with:
All that is left to do is to add the menu to the menubar, which is accomplished using the method:
which in our case looks like this:
If we wanted the menu right justified on the menubar, such as help menus often are, we can use the following method (again on file_item in the current example) before attaching it to the menubar.
Here is a summary of the steps needed to create a menu bar with menus attached:
Creating a popup menu is nearly the same. The difference is that the menu is not posted "automatically" by a menubar, but explicitly by calling the popup() method from a button-press event, for example. Take these steps:
|