Python Tkinter LabelFrame Widget

Tkinter LabelFrame is a widget in the Tkinter GUI toolkit that serves as a container to group and organize other widgets.

It provides a border and a title to the group of widgets, and it can also be used to provide a visual separation between different sections of the user interface.

LabelFrame is derived from the Frame widget and inherits all of its properties and methods. In addition, it provides several specific options, such as the text option to set the title of the LabelFrame, and the labelanchor option to specify the position of the title within the frame.

This lesson is about the Tkinter LabelFrame widget, which is used to group related widgets and add a border and title to them. The lesson covers the syntax and options of the LabelFrame widget, as well as its methods and various use cases.

Additionally, there are multiple-choice quiz questions with answers to test your understanding of the widget. Overall, this lesson provides a comprehensive guide to using the LabelFrame widget in Tkinter for Python GUI development.

To use a LabelFrame, first, create an instance of the widget and specify its parent widget as an argument. Then, add the child widgets to the LabelFrame by calling their pack() or grid() methods with the LabelFrame as the parent.

Overall, the Tkinter LabelFrame is a useful tool for creating well-organized and visually appealing user interfaces.

How to create LabelFrame?

To create a LabelFrame in Tkinter, you can follow these steps:

1-Import the Tkinter module:

import tkinter as tk

2-Create a Tkinter instance and set a title:

root = tk.Tk()

root.title("My Application")

3- Create a LabelFrame instance and specify its parent widget:

my_label_frame = tk.LabelFrame(root, text="My LabelFrame")

4-Add child widgets to the LabelFrame by calling their pack() or grid() methods with the LabelFrame as the parent:

my_label = tk.Label(my_label_frame, text="Hello World!")

my_label.pack()

5-Finally, pack() or grid() the LabelFrame itself to display it in the main window:

my_label_frame.pack()

Here’s the complete example code:

import tkinter as tk

root = tk.Tk()
root.title("My Application")

my_label_frame = tk.LabelFrame(root, text="My LabelFrame")

my_label = tk.Label(my_label_frame, text="Hello World!")
my_label.pack()

my_label_frame.pack()

root.mainloop()

This will create a window with a LabelFrame containing a label that says “Hello World!”.

General syntax

The general syntax for creating a Tkinter LabelFrame widget is as follows:

label_frame = tk.LabelFrame(parent, options)

where:

parent is the parent widget, i.e., the widget that will contain the LabelFrame.

options are the optional configuration options that can be used to customize the appearance and behavior of the LabelFrame.

Some of the most commonly used options for LabelFrame include:

text: the title or label of the frame.

labelanchor: the position of the title within the frame.

borderwidth: the width of the border around the frame.

relief: the style of the border, e.g., “groove”, “ridge”, “solid”, etc.

Once the LabelFrame is created, you can add child widgets to it by calling their pack() or grid() methods with the LabelFrame as the parent.

For example, to create a LabelFrame with a title “My Frame” and a child Label widget with the text “Hello World!”, you can use the following code:

import tkinter as tk
root = tk.Tk()
my_frame = tk.LabelFrame(root, text="Frame test")
my_frame.pack()
my_label = tk.Label(my_frame, text="Welcome!")
my_label.pack()
root.mainloop()

This will create a window with a LabelFrame containing a Label widget inside it.

Options of LabelFrame Widget

text –

Sets the text to be displayed as the title or label of the frame.

import tkinter as tk
root = tk.Tk()
my_frame = tk.LabelFrame(root, text="Frame test")
my_frame.pack()
my_label = tk.Label(my_frame, text="I am a frame!")
my_label.pack()
root.mainloop()

labelanchor 

Sets the position of the title within the frame. The default value is “nw” (northwest).

import tkinter as tk

root = tk.Tk()

my_frame = tk.LabelFrame(root, text="My Frame", labelanchor="nw")
my_frame.pack()
my_label = tk.Label(my_frame, text="I am a frame!")
my_label.pack()
root.mainloop()

Borderwidth 

Sets the width of the border around the frame. The default value is 2.

import tkinter as tk

root = tk.Tk()

my_frame = tk.LabelFrame(root, text="My Frame", borderwidth=5)
my_frame.pack()
my_label = tk.Label(my_frame, text="I am a frame!")
my_label.pack()
root.mainloop()

relief

Sets the style of the border around the frame. The default value is “groove”.

import tkinter as tk

root = tk.Tk()

my_frame = tk.LabelFrame(root, text="My Frame", relief="solid")
my_frame.pack()
my_label = tk.Label(my_frame, text="I am a frame!")
my_label.pack()
root.mainloop()
 

background or bg 

Sets the background color of the frame.

foreground or fg –

Sets the foreground color of the text inside the frame.

import tkinter as tk
root = tk.Tk()
my_frame = tk.LabelFrame(root, text="My Frame", fg="red")
my_frame.pack()
my_label = tk.Label(my_frame, text="I am a frame!")
my_label.pack()

root.mainloop()

font –

Sets the font to be used for the text inside the frame.

import tkinter as tk

root = tk.Tk()
my_frame = tk.LabelFrame(root, text="My Frame", font=("Arial", 14))
my_frame.pack()
my_label = tk.Label(my_frame, text="I am a frame!")
my_label.pack()

root.mainloop()

width –

Sets the width of the frame in characters.

import tkinter as tk
root = tk.Tk()
my_frame = tk.LabelFrame(root, text="My Frame", labelanchor="n", borderwidth=5,font=("Arial", 14), width=150)
my_frame.pack()
my_label = tk.Label(my_frame, text="I am a frame!")
my_label.pack()
root.mainloop()

Height –

Sets the height of the frame in characters.

import tkinter as tk
root = tk.Tk()
my_frame = tk.LabelFrame(root, text="My Frame", height=5)
my_frame.pack()
my_label = tk.Label(my_frame, text="I am a frame!")
my_label.pack()

root.mainloop()

padx and pady 

Sets the amount of padding to be added horizontally and vertically, respectively, between the frame and its contents.

import tkinter as tk
root = tk.Tk()
my_frame = tk.LabelFrame(root, text="My Frame", padx=10, pady=5)
my_frame.pack()
my_label = tk.Label(my_frame, text="Hello World!")
my_label.pack()
root.mainloop()

cursor –

Sets the type of cursor to be displayed when the mouse pointer is over the frame.

import tkinter as tk
root = tk.Tk()
my_frame = tk.LabelFrame(root, text="My Frame", cursor="hand2")
my_frame.pack()
my_label = tk.Label(my_frame, text="Hello World!")
my_label.pack()
root.mainloop()

borderwidth

– Sets the width of the frame’s border.

import tkinter as tk
root = tk.Tk()
my_frame = tk.LabelFrame(root, text="My Frame", borderwidth=10)
my_frame.pack()
my_label = tk.Label(my_frame, text="Hello World!")
my_label.pack()
root.mainloop()

These options can be used to further customize the appearance and behavior of the Tkinter LabelFrame widget to suit your needs.