{"id":1403,"date":"2020-12-02T04:06:52","date_gmt":"2020-12-02T04:06:52","guid":{"rendered":"https:\/\/www.pythontutorial.net\/?page_id=1403"},"modified":"2021-11-20T09:56:57","modified_gmt":"2021-11-20T09:56:57","slug":"tkinter-labelframe","status":"publish","type":"page","link":"https:\/\/www.pythontutorial.net\/tkinter\/tkinter-labelframe\/","title":{"rendered":"Tkinter LabelFrame"},"content":{"rendered":"\n

Summary<\/strong>: in this tutorial, you’ll how to use the Tkinter LabelFrame<\/code> widget that contains other widgets.<\/p>\n\n\n\n

Introduction to the Tkinter LabelFrame #<\/a><\/h2>\n\n\n\n

Tkinter LabelFrame<\/code> widget is a container that contains other related widgets. For example, you can group Radiobutton widgets and place the group on a LabelFrame<\/code>.<\/p>\n\n\n\n

To create a LabelFrame<\/code> widget, you use the ttk.LabelFrame<\/code>:<\/p>\n\n\n

lf = ttk.LabelFrame(container, **option)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
In this syntax, you specify the parent component (container<\/code>) of the LabelFrame<\/code> and one or more options. A notable option is text<\/code> which specifies a label for the LabelFrame<\/code>.<\/p>\n\n\n\n
Tkinter LabelFrame widget example #<\/a><\/h2>\n\n\n\n
The following program illustrates how to create a LabelFrame<\/code> widget that groups three radio buttons:<\/p>\n\n\n
import<\/span> tkinter as<\/span> tk\nfrom<\/span> tkinter import<\/span> ttk\n\n# root window<\/span>\nroot = tk.Tk()\n\n# configure the root window<\/span>\nroot.geometry('300x200'<\/span>)\nroot.resizable(False<\/span>, False<\/span>)\nroot.title('LabelFrame Demo'<\/span>)\n\n# label frame<\/span>\nlf = ttk.LabelFrame(root, text='Alignment'<\/span>)\nlf.grid(column=0<\/span>, row=0<\/span>, padx=20<\/span>, pady=20<\/span>)\n\nalignment_var = tk.StringVar()\nalignments = ('Left'<\/span>, 'Center'<\/span>, 'Right'<\/span>)\n\n# create radio buttons and place them on the label frame<\/span>\n\ngrid_column = 0<\/span>\nfor<\/span> alignment in<\/span> alignments:\n    # create a radio button<\/span>\n    radio = ttk.Radiobutton(lf, text=alignment, value=alignment, variable=alignment_var)\n    radio.grid(column=grid_column, row=0<\/span>, ipadx=10<\/span>, ipady=10<\/span>)\n    # grid column<\/span>\n    grid_column += 1<\/span>\n\nroot.mainloop()<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n\n
\"Tkinter<\/figure><\/div>\n\n\n\n
How it works.<\/p>\n\n\n\n
First, create a LabelFrame<\/code> widget and use the grid geometry manager to manage its layout:<\/p>\n\n\n
lf = ttk.LabelFrame(root, text='Alignment'<\/span>)\nlf.grid(column=0<\/span>, row=0<\/span>, padx=20<\/span>, pady=20<\/span>)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
grid_column = 0<\/span>\n\nfor<\/span> alignment in<\/span> alignments:\n    # create a radio button<\/span>\n    radio = ttk.Radiobutton(lf, text=alignment, value=alignment, variable=alignment_var)\n    radio.grid(column=grid_column, row=0<\/span>, ipadx=10<\/span>, ipady=10<\/span>)\n    # grid column<\/span>\n    grid_column += 1<\/span><\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Specify the label position #<\/a><\/h2>\n\n\n\n
To specify the position of the label on the widget, you use the labelanchor<\/code> option. The labelanchor<\/code> defaults to 'nw'<\/code>, which places the label at the left end of the top border:<\/p>\n\n\n\n
\"tkinter<\/figure><\/div>\n\n\n\n
The following program illustrates the label anchor options. When you select a label option, the label of the LabelFrame widget change accordingly:<\/p>\n\n\n\n
\"Tkinter<\/figure><\/div>\n\n\n
import<\/span> tkinter as<\/span> tk\nfrom<\/span> tkinter import<\/span> ttk\n\n# root window<\/span>\nroot = tk.Tk()\nroot.title('LabelFrame Label Anchor'<\/span>)\n\n# label frame<\/span>\nlf = ttk.LabelFrame(root, text='Label Anchor'<\/span>)\nlf.grid(column=0<\/span>, row=0<\/span>, padx=20<\/span>, pady=20<\/span>, sticky=tk.NSEW)\n\nanchor_var = tk.StringVar()\nanchors = {\n    'nw'<\/span>: {'row'<\/span>: 0<\/span>, 'column'<\/span>: 1<\/span>},\n    'n'<\/span>: {'row'<\/span>: 0<\/span>, 'column'<\/span>: 2<\/span>},\n    'ne'<\/span>: {'row'<\/span>: 0<\/span>, 'column'<\/span>: 3<\/span>},\n    'en'<\/span>: {'row'<\/span>: 1<\/span>, 'column'<\/span>: 4<\/span>},\n    'e'<\/span>: {'row'<\/span>: 2<\/span>, 'column'<\/span>: 4<\/span>},\n    'es'<\/span>: {'row'<\/span>: 3<\/span>, 'column'<\/span>: 4<\/span>},\n    'se'<\/span>: {'row'<\/span>: 4<\/span>, 'column'<\/span>: 3<\/span>},\n    's'<\/span>: {'row'<\/span>: 4<\/span>, 'column'<\/span>: 2<\/span>},\n    'sw'<\/span>: {'row'<\/span>: 4<\/span>, 'column'<\/span>: 1<\/span>},\n    'ws'<\/span>: {'row'<\/span>: 3<\/span>, 'column'<\/span>: 0<\/span>},\n    'w'<\/span>: {'row'<\/span>: 2<\/span>, 'column'<\/span>: 0<\/span>},\n    'wn'<\/span>: {'row'<\/span>: 1<\/span>, 'column'<\/span>: 0<\/span>}\n}\n\n\ndef<\/span> change_label_anchor<\/span>()<\/span>:<\/span>\n    lf['labelanchor'<\/span>] = anchor_var.get()\n\n\n# create radio buttons and place them on the label frame<\/span>\nfor<\/span> key, value in<\/span> anchors.items():\n    # create a radio button<\/span>\n    radio = ttk.Radiobutton(\n        lf,\n        text=key.upper(),\n        value=key,\n        command=change_label_anchor,\n        variable=anchor_var\n    ).grid(**value, padx=10<\/span>, pady=10<\/span>, sticky=tk.NSEW)\n\n# set the radio button selected<\/span>\nanchor_var.set(lf['labelanchor'<\/span>])\n\n# show the root window<\/span>\nroot.mainloop()<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
How it works.<\/p>\n\n\n\n
First, create a LabelFrame widget and place it on the root window:<\/p>\n\n\n
lf = ttk.LabelFrame(root, text='Label Anchor'<\/span>)\nlf.grid(column=0<\/span>, row=0<\/span>, padx=20<\/span>, pady=20<\/span>, sticky=tk.NSEW)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Next, define a StringVar object that will associate with the radio buttons:<\/p>\n\n\n
anchor_var = tk.StringVar()<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Then, define a dictionary with the key stores the label options and value stores the cell (row, column) of the grid:<\/p>\n\n\n
anchors = {\n    'nw'<\/span>: {'row'<\/span>: 0<\/span>, 'column'<\/span>: 1<\/span>},\n    'n'<\/span>: {'row'<\/span>: 0<\/span>, 'column'<\/span>: 2<\/span>},\n    'ne'<\/span>: {'row'<\/span>: 0<\/span>, 'column'<\/span>: 3<\/span>},\n    'en'<\/span>: {'row'<\/span>: 1<\/span>, 'column'<\/span>: 4<\/span>},\n    'e'<\/span>: {'row'<\/span>: 2<\/span>, 'column'<\/span>: 4<\/span>},\n    'es'<\/span>: {'row'<\/span>: 3<\/span>, 'column'<\/span>: 4<\/span>},\n    'se'<\/span>: {'row'<\/span>: 4<\/span>, 'column'<\/span>: 3<\/span>},\n    's'<\/span>: {'row'<\/span>: 4<\/span>, 'column'<\/span>: 2<\/span>},\n    'sw'<\/span>: {'row'<\/span>: 4<\/span>, 'column'<\/span>: 1<\/span>},\n    'ws'<\/span>: {'row'<\/span>: 3<\/span>, 'column'<\/span>: 0<\/span>},\n    'w'<\/span>: {'row'<\/span>: 2<\/span>, 'column'<\/span>: 0<\/span>},\n    'wn'<\/span>: {'row'<\/span>: 1<\/span>, 'column'<\/span>: 0<\/span>}\n}<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
After that, define a function that handles the radio button change event. The function changes the labelanchor<\/code> option of the LabelFrame<\/code> widget to the value of the selected radio button:<\/p>\n\n\n
def<\/span> change_label_anchor<\/span>()<\/span>:<\/span>\n    lf['labelanchor'<\/span>] = anchor_var.get()<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Finally, create the radio buttons from the anchors<\/code> dictionary and place them on the LabelFrame widget:<\/p>\n\n\n
for<\/span> key, value in<\/span> anchors.items():\n    # create a radio button<\/span>\n    radio = ttk.Radiobutton(\n        lf,\n        text=key.upper(),\n        value=key,\n        command=change_label_anchor,\n        variable=anchor_var\n    ).grid(**value, padx=10<\/span>, pady=10<\/span>, sticky=tk.NSEW)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Summary #<\/a><\/h2>\n\n\n\n
  • Use LabelFrame<\/code> widget to group related widgets into one group.<\/li>
  • Use ttk.LabelFrame(container, **option)<\/code> to create a LabelFrame<\/code> widget.<\/li><\/ul>\n
    \n\t
    \n\t\t
    Was this tutorial helpful ?<\/div>\n\t\t
    \n\t\t\t\n\t\t\t\t\n\t\t\t\t\t<\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t Yes <\/span>\n\t\t\t<\/button>\n\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t<\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t No <\/span>\n\t\t\t<\/button>\n\t\t<\/div>\n\t<\/header>\n\n\t
    \n\t\t
    \n\t\t\t
    <\/div>\n\t\t\t
Second, create the three radio button<\/a> widgets based on the alignments list and place them on the label frame widget:<\/p>\n\n\n