Python Tkinter Menubutton


A menubutton is the part of a drop-down menu that stays on the screen all the time. Every menubutton is associated with a Menu widget that can display the choices for that menubutton when the user clicks on it.


Here is the simple syntax to create this widget −

  w = Menubutton ( master, option, ... )


  • master: This represents the parent window.

  • options: Here is the list of most commonly used options for this widget. These options can be used as key-value pairs separated by commas.

activebackgroundThe background color when the mouse is over the menubutton.
activeforegroundThe foreground color when the mouse is over the menubutton.
anchorThis options controls where the text is positioned if the widget has more space than the text needs. The default is anchor=CENTER, which centers the text.
bgThe normal background color displayed behind the label and indicator.
bitmapTo display a bitmap on the menubutton, set this option to a bitmap name.
bd The size of the border around the indicator. Default is 2 pixels.
cursorThe cursor that appears when the mouse is over this menubutton.
directionSet direction=LEFT to display the menu to the left of the button; use direction=RIGHT to display the menu to the right of the button; or use direction='above' to place the menu above the button.
disabledforeground The foreground color shown on this menubutton when it is disabled.
fg The foreground color when the mouse is not over the menubutton.
heightThe height of the menubutton in lines of text (not pixels!). The default is to fit the menubutton's size to its contents.
highlightcolorColor shown in the focus highlight when the widget has the focus.
imageTo display an image on this menubutton,
justifyThis option controls where the text is located when the text doesn't fill the menubutton: use justify=LEFT to left-justify the text (this is the default); use justify=CENTER to center it, or justify=RIGHT to right-justify.
menuTo associate the menubutton with a set of choices, set this option to the Menu object containing those choices. That menu object must have been created by passing the associated menubutton to the constructor as its first argument.
padxHow much space to leave to the left and right of the text of the menubutton. Default is 1.
padyHow much space to leave above and below the text of the menubutton. Default is 1.
reliefSelects three-dimensional border shading effects. The default is RAISED.
stateNormally, menubuttons respond to the mouse. Set state=DISABLED to gray out the menubutton and make it unresponsive.
textTo display text on the menubutton, set this option to the string containing the desired text. Newlines ("\n") within the string will cause line breaks.
textvariableYou can associate a control variable of class StringVar with this menubutton. Setting that control variable will change the displayed text.
underlineNormally, no underline appears under the text on the menubutton. To underline one of the characters, set this option to the index of that character.
widthThe width of the widget in characters. The default is 20.
wraplengthNormally, lines are not wrapped. You can set this option to a number of characters and all lines will be broken into pieces no longer than that number.


Try the following example yourself −

from Tkinter import *
import tkMessageBox
import Tkinter

top = Tk()

mb=  Menubutton ( top, text="condiments", relief=RAISED )
mb.grid()  =  Menu ( mb, tearoff = 0 )
mb["menu"]  =
mayoVar  = IntVar()
ketchVar = IntVar() ( label="mayo",
                          variable=mayoVar ) ( label="ketchup",
                          variable=ketchVar )


When the above code is executed, it produces the following result −

TK Menubutton