LAST UPDATED: AUGUST 24, 2020
Python Tkinter Toplevel Widget
In this tutorial, we will cover the Tkinter Toplevel widget in Python which is used to create and display top-level windows other than the application window.
-
With the help of the Tkinter Toplevel widget, you can provide extra information to the user in a separate window on top of the parent window.
-
This top-level window created using the Toplevel widget is directly organized and managed by the window manager.
-
It is not necessary for the top-level windows to have parents on their top.
-
You can create multiple top-level windows one over the other.
-
Top-level windows created using Top-level widgets contain title bars, borders, and some window decorations too.
-
With the help of this widget, you can provide pop-ups, some extra information, or some widgets on the new window if you want.
Python Tkinter Toplevel Widget
The syntax of the Tkinter Toplevel widget is given below:
W = Toplevel(master,options)
In the above syntax, the master parameter denotes the parent window. You can use many options to configure your Toplevel widget and these options are written as comma-separated key-value pairs.
Tkinter Toplevel Widget Options:
Following are the various options used with Tkinter Toplevel widgets are given below:
| Name of the option |
Description |
bd |
To represent the border size of the window |
bg |
To represent the background color of the window |
class_ |
Generally, the text selected in the text widget is simply exported to be selected to the window manager. You can also set the value of this option to 0 to make this kind of behavior false. |
cursor |
This option will convert the mouse pointer to the specified cursor type and it can be set to an arrow, dot, etc. |
width |
This option is used to represent the width of the window |
height |
This option is used to represent the height of the window |
font |
This option indicates the font type of the text to be inserted into the widget. |
fg |
This option is used to indicate the foreground color of the widget. |
relief |
This option indicates the type of the window. |
Tkinter Toplevel Widget Methods:
Following are the various methods used with Tkinter Toplevel widgets are given below:
| Method |
Description |
title(string) |
This method is used to define the title for the window. |
withdraw() |
This method is used to delete the window but it would not destroy the window. |
positionfrom(who) |
This method is used to define the position controller |
sizefrom(who) |
This method is used to define the size controller. |
minsize(width,height) |
This method is used to declare the minimum size for the window |
maxsize(width,height) |
This method is used to declare the maximum size for the window |
resizable(width,height) |
This method is used to control whether the window can be resizable or not. |
transient([master]) |
This method is used to convert the window into a temporary window |
iconify() |
This method is used to convert the top-level window into an icon. |
deiconify() |
This method is mainly used to display the window. |
frame() |
To indicate a system-dependent window identifier this method is used. |
group(window) |
This method is used to add a top-level window to a specified window group |
protocol(name,function) |
This method is used to indicate a function which will be called for the specific protocol |
state() |
This method is used to get the current state of the window. Some Possible values of this option are normal, iconic, withdrawn, and icon. |
Tkinter Toplevel Widget Example
Below we have a basic example where we will create a simple top-level window.
from tkinter import *
win = Tk()
win.geometry("200x200")
def open():
top = Toplevel(win)
top.mainloop()
btn = Button(win, text="open", command=open)
btn.place(x=75, y=50)
win.mainloop()
In the code above, we have created a Toplevel widget that is created and started when the Button is clicked.
Summary:
So now we know what a Tkinter Toplevel widget is and how to create it. The Tkinter Toplevel widget is good to show some section of your application in a different window which is displayed on the top of the main application window.
