Python Tkinter Toplevel


Toplevel widgets work as windows that are directly managed by the window manager. They do not necessarily have a parent widget on top of them.

Your application can use any number of top-level windows.


Here is the simple syntax to create this widget:

w = Toplevel ( option, ... )


  • 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.

bg The background color of the window.
bd Border width in pixels; default is 0.
cursor The cursor that appears when the mouse is in this window.
class_ Normally, text selected within a text widget is exported to be the selection in the window manager. Set exportselection=0 if you don't want that behavior.
font The default font for text inserted into the widget.
fg The color used for text (and bitmaps) within the widget. You can change the color for tagged regions; this option is just the default.
height Window height.
relief Normally, a top-level window will have no 3-d borders around it. To get a shaded border, set the bd option larger that its default value of zero, and set the relief option to one of the constants.
width The desired width of the window.


Toplevel objects have these methods:

Methods & Description
Displays the window, after using either the iconify or the withdraw methods.
Returns a system-specific window identifier.
Adds the window to the window group administered by the given window.
Turns the window into an icon, without destroying it.
protocol(name, function)
Registers a function as a callback which will be called for the given protocol.
Turns the window into an icon, without destroying it.
Returns the current state of the window. Possible values are normal, iconic, withdrawn and icon.
Turns the window into a temporary(transient) window for the given master or to the window's parent, when no argument is given.
Removes the window from the screen, without destroying it.
maxsize(width, height)
Defines the maximum size for this window.
minsize(width, height)
Defines the minimum size for this window.
Defines the position controller.
resizable(width, height)
Defines the resize flags, which control whether the window can be resized.
Defines the size controller.
Defines the window title.


Try following example yourself:

from Tkinter import *

root = Tk()
top = Toplevel()


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

TK Toplevel