Tkinter is Python’s standard GUI library. It ships with every Python installation, requires no separate installation, and provides enough widgets to build real desktop applications. This guide walks through the most commonly used Tkinter widgets, with working examples you can run right away.<\/p>\n\n
Each widget handles a specific UI role – from displaying text to accepting user input. Once you know what each one does, combining them with layout managers like Every Tkinter application follows the same three-step pattern: import the library, create the root window, and start the event loop.<\/p>\n\n The Common Label parameters: Buttons are interactive widgets that call a function when clicked. You pass the function reference to the When a button is clicked, Tkinter calls the function assigned to A Each The The Key Scale parameters: The All four Q: How do I run a Tkinter application?<\/strong><\/p>\n\n\n\n Save your Python code to a file with a .py extension and run it with python filename.py. The application launches in a native window. Tkinter applications require an active display environment to render GUI windows.<\/p>\n\n\n\n Q: What is the difference between pack() and grid()?<\/strong><\/p>\n\n\n\n Q: Can Tkinter display images?<\/strong><\/p>\n\n\n\n Yes. Use the Q: How do I handle multiple windows?<\/strong><\/p>\n\n\n\n Create additional Tkinter provides a complete GUI toolkit out of the box. These seven widgets cover the foundations of most Tkinter applications. Combine them with layout managers to arrange them on screen, and you will be building functional desktop interfaces in short order.<\/p>\n","protected":false},"excerpt":{"rendered":" Tkinter is Python’s standard GUI library. It ships with every Python installation, requires no separate installation, and provides enough widgets to build real desktop applications. This guide walks through the most commonly used Tkinter widgets, with working examples you can run right away. Each widget handles a specific UI role – from displaying text to […]<\/p>\n","protected":false},"author":12,"featured_media":68131,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1,92],"tags":[],"class_list":["post-8313","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-python","category-tkinter"],"_links":{"self":[{"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/posts\/8313","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/comments?post=8313"}],"version-history":[{"count":0,"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/posts\/8313\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/media\/68131"}],"wp:attachment":[{"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/media?parent=8313"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/categories?post=8313"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.askpython.com\/wp-json\/wp\/v2\/tags?post=8313"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}pack()<\/code> and grid()<\/code> lets you build complete interfaces.<\/p>\n\n\nTLDR<\/h2>\n\n\n\n
\n
Setting Up the Main Window<\/h2>\n\n\n
\n\nimport tkinter as tk\n\n# Create the root window\nroot = tk.Tk()\nroot.title("My First GUI App")\nroot.geometry("400x300") # Width x Height in pixels\n\n# Your widgets go here\nlabel = tk.Label(root, text="Hello, Tkinter!")\nlabel.pack()\n\n# Start the event loop\nroot.mainloop()\n\n<\/pre><\/div>\n\ntk.Tk()<\/code> creates the main application window. geometry()<\/code> sets its dimensions in pixels. mainloop()<\/code> runs the event listener for clicks, keystrokes, and other user interactions – the program stays here until the window is closed. Everything between creating the window and calling mainloop()<\/code> is where you assemble your interface.<\/p>\n\n\nLabel – Display Text and Images<\/h2>\n\n\n
Label<\/code> widget displays read-only text or images. It is the simplest widget and appears throughout Tkinter applications for headings, descriptions, status messages, and image previews.<\/p>\n\n\n\nimport tkinter as tk\n\nroot = tk.Tk()\nroot.title("Label Demo")\nroot.geometry("400x200")\n\n# Basic text label\ntitle_label = tk.Label(\n root,\n text="Welcome to Tkinter!",\n font=("Arial", 18, "bold"),\n fg="darkblue"\n)\ntitle_label.pack(pady=10)\n\n# Label with wrapping and center alignment\ndescription = tk.Label(\n root,\n text="Labels display static text. They are read-only - "\n "use Entry widgets for user input.",\n font=("Arial", 10),\n fg="gray",\n wraplength=350,\n justify="center"\n)\ndescription.pack(pady=10)\n\n# Label with background color\nhighlight = tk.Label(\n root,\n text="Colored backgrounds are easy too!",\n font=("Arial", 12, "italic"),\n bg="lightyellow",\n padx=20,\n pady=10\n)\nhighlight.pack(pady=10)\n\nroot.mainloop()\n\n<\/pre><\/div>\n\ntext<\/code> sets the displayed string, font<\/code> controls typography, fg<\/code> sets text color, bg<\/code> sets background color, wraplength<\/code> controls line width, and justify<\/code> sets text alignment.<\/p>\n\n\nButton – Trigger Actions on Click<\/h2>\n\n\n
command<\/code> parameter – pass the function name without parentheses.<\/p>\n\n\n\nimport tkinter as tk\n\ndef on_click():\n label.config(text="Button was clicked!", fg="green")\n\ndef on_reset():\n label.config(text="Press the button above", fg="black")\n\nroot = tk.Tk()\nroot.title("Button Demo")\nroot.geometry("400x200")\n\nlabel = tk.Label(root, text="Press the button below", font=("Arial", 14))\nlabel.pack(pady=30)\n\n# A regular button\nmy_button = tk.Button(\n root,\n text="Click Me!",\n command=on_click,\n font=("Arial", 12),\n bg="cornflowerblue",\n fg="white",\n padx=20,\n pady=5,\n cursor="hand2"\n)\nmy_button.pack(pady=10)\n\n# A reset button\nreset_button = tk.Button(\n root,\n text="Reset",\n command=on_reset,\n font=("Arial", 10),\n bg="lightgray"\n)\nreset_button.pack(pady=5)\n\nroot.mainloop()\n\n<\/pre><\/div>\n\ncommand<\/code>. Both buttons above modify the same Label by calling different functions – demonstrating how multiple widgets interact through shared functions. The cursor=\"hand2\"<\/code> parameter gives the button a hand cursor on hover.<\/p>\n\n\nCheckbutton – Toggle Boolean States<\/h2>\n\n\n
Checkbutton<\/code> is a two-state toggle – checked or unchecked. It pairs with an IntVar<\/code> to store its state. When the user checks or unchecks it, the variable automatically updates to 1 or 0.<\/p>\n\n\n\nimport tkinter as tk\n\ndef show_settings():\n output = []\n if python_check.get():\n output.append("Python enabled")\n if java_check.get():\n output.append("Java enabled")\n if cpp_check.get():\n output.append("C++ enabled")\n if not output:\n output.append("No languages selected")\n result_label.config(text="\\n".join(output))\n\nroot = tk.Tk()\nroot.title("Checkbutton Demo")\nroot.geometry("400x250")\n\nintro = tk.Label(root, text="Select your programming languages:",\n font=("Arial", 12, "bold"))\nintro.pack(pady=10)\n\n# IntVar stores 1 (checked) or 0 (unchecked)\npython_check = tk.IntVar()\njava_check = tk.IntVar()\ncpp_check = tk.IntVar()\n\ntk.Checkbutton(\n root,\n text="Python",\n variable=python_check,\n command=show_settings,\n font=("Arial", 11)\n).pack(anchor="w", padx=100)\n\ntk.Checkbutton(\n root,\n text="Java",\n variable=java_check,\n command=show_settings,\n font=("Arial", 11)\n).pack(anchor="w", padx=100)\n\ntk.Checkbutton(\n root,\n text="C++",\n variable=cpp_check,\n command=show_settings,\n font=("Arial", 11)\n).pack(anchor="w", padx=100)\n\nresult_label = tk.Label(root, text="No languages selected",\n font=("Arial", 10), fg="green")\nresult_label.pack(pady=20)\n\nroot.mainloop()\n\n<\/pre><\/div>\n\nCheckbutton<\/code> gets its own IntVar<\/code>. When you click a checkbox, Tkinter automatically sets that variable to 1 or 0. Set the initial state with python_check.set(1)<\/code>. This widget suits settings panels, feature toggles, and multi-select scenarios.<\/p>\n\n\nEntry – Single-Line Text Input<\/h2>\n\n\n
Entry<\/code> widget accepts a single line of text input. It works with a StringVar<\/code> to read and write its value. Use .get()<\/code> to retrieve the current text and .set()<\/code> to change it programmatically.<\/p>\n\n\n<pre class="wp-block-syntaxhighlighter-code">\nimport tkinter as tk\n\ndef submit():\n name = name_var.get()\n if name.strip():\n greeting.config(text=f"Hello, {name.strip()}! Welcome to Tkinter.")\n else:\n greeting.config(text="Please enter your name.")\n\ndef clear():\n name_var.set("")\n greeting.config(text="")\n\nroot = tk.Tk()\nroot.title("Entry Demo")\nroot.geometry("400x220")\n\ntk.Label(root, text="Enter your name:",\n font=("Arial", 12, "bold")).pack(pady=10)\n\n# StringVar to hold the entry text\nname_var = tk.StringVar()\n\nentry = tk.Entry(root, textvariable=name_var, font=("Arial", 12), width=30)\nentry.pack(pady=5)\n\n# Focus the cursor here automatically when the window opens\nentry.focus()\n\n# Bind the Enter key to submit\nentry.bind("<Return>", lambda e: submit())\n\nsubmit_btn = tk.Button(root, text="Submit", command=submit,\n font=("Arial", 11), bg="steelblue", fg="white")\nsubmit_btn.pack(pady=5)\n\nclear_btn = tk.Button(root, text="Clear", command=clear,\n font=("Arial", 11), bg="lightgray")\nclear_btn.pack(pady=5)\n\ngreeting = tk.Label(root, text="", font=("Arial", 13, "italic"), fg="navy")\ngreeting.pack(pady=15)\n\nroot.mainloop()\n<\/pre>\n<\/pre><\/div>\n\nentry.bind(\"focus()<\/code> call ensures the text field is ready when the window opens.<\/p>\n\n\nScale – Slider for Numerical Input<\/h2>\n\n\n
Scale<\/code> widget provides a draggable slider for selecting a numeric value within a range. It suits volume controls, color pickers, and any scenario where picking a value within a range is more intuitive than typing a number.<\/p>\n\n\n\nimport tkinter as tk\n\ndef show_value(value):\n result.config(text=f"Selected value: {value}")\n\nroot = tk.Tk()\nroot.title("Scale Demo")\nroot.geometry("400x300")\n\ntk.Label(root, text="Adjust the volume:",\n font=("Arial", 14, "bold")).pack(pady=10)\n\n# IntVar to track the scale value\nvolume = tk.IntVar()\nvolume.set(50) # Default value\n\n# A horizontal scale from 0 to 100\nscale = tk.Scale(\n root,\n from_=0, # Minimum value\n to=100, # Maximum value\n orient="horizontal",\n variable=volume,\n command=show_value,\n length=300,\n tickinterval=20,\n showvalue=True\n)\nscale.pack(pady=20)\n\nresult = tk.Label(root, text="Selected value: 50",\n font=("Arial", 12), fg="darkgreen")\nresult.pack(pady=10)\n\n# Button to print the current value\ntk.Button(root, text="Confirm Volume",\n command=lambda: print(f"Volume set to: {volume.get()}"),\n font=("Arial", 11), bg="darkgreen", fg="white").pack(pady=5)\n\nroot.mainloop()\n\n<\/pre><\/div>\n\nfrom_<\/code> and to<\/code> define the range, orient<\/code> controls horizontal or vertical layout, tickinterval<\/code> adds tick marks at intervals, and showvalue<\/code> displays the current numeric value above the slider. The command<\/code> callback receives the current value as a string argument each time the slider moves.<\/p>\n\n\nListbox – List Selection<\/h2>\n\n\n
Listbox<\/code> widget displays a scrollable list of items. It supports single or multiple selection, and you retrieve selected item(s) with curselection()<\/code>.<\/p>\n\n\n<pre class="wp-block-syntaxhighlighter-code">\nimport tkinter as tk\n\ndef show_selection():\n selection = languages_listbox.curselection()\n if selection:\n selected = languages_listbox.get(selection[0])\n result.config(text=f"You selected: {selected}")\n else:\n result.config(text="No item selected")\n\nroot = tk.Tk()\nroot.title("Listbox Demo")\nroot.geometry("400x300")\n\ntk.Label(root, text="Choose a programming language:",\n font=("Arial", 13, "bold")).pack(pady=10)\n\n# Create and populate the listbox\nlanguages_listbox = tk.Listbox(root, font=("Arial", 12), height=8)\nlanguages = ["Python", "Java", "C++", "JavaScript", "Rust",\n "Go", "TypeScript", "Kotlin"]\nfor lang in languages:\n languages_listbox.insert("end", lang)\nlanguages_listbox.pack(pady=5)\n\n# Select the first item by default\nlanguages_listbox.select_set(0)\n\n# Bind double-click to selection\nlanguages_listbox.bind("<Double-Button-1>", lambda e: show_selection())\n\ntk.Button(root, text="Confirm Selection",\n command=show_selection,\n font=("Arial", 11), bg="purple", fg="white").pack(pady=5)\n\nresult = tk.Label(root, text="", font=("Arial", 11), fg="purple")\nresult.pack(pady=10)\n\nroot.mainloop()\n<\/pre>\n<\/pre><\/div>\n\ncurselection()<\/code> returns a tuple of selected indices. Use listbox.get(index)<\/code> to retrieve the item at a given index. insert(\"end\", item)<\/code> adds items to the end of the list. For multiple selection mode, set selectmode=\"multiple\"<\/code> and iterate over curselection()<\/code> to handle multiple indices.<\/p>\n\n\nRadiobutton – Mutually Exclusive Choices<\/h2>\n\n\n
Radiobutton<\/code> widgets belong to a group where only one can be selected at a time. They share an IntVar<\/code>, and each button is associated with a different value. Selecting a new button automatically deselects the previous one.<\/p>\n\n\n\nimport tkinter as tk\n\ndef show_choice():\n result.config(text=f"You chose: {choice.get()} (value: {choice.get()})")\n\nroot = tk.Tk()\nroot.title("Radiobutton Demo")\nroot.geometry("400x280")\n\ntk.Label(root, text="Select your experience level:",\n font=("Arial", 13, "bold")).pack(pady=10)\n\n# Single IntVar shared across all radio buttons\nchoice = tk.IntVar()\nchoice.set(1) # Default selection\n\n# Radiobutton with integer value\ntk.Radiobutton(\n root,\n text="Beginner - I'm just starting out",\n variable=choice,\n value=1,\n command=show_choice,\n font=("Arial", 11)\n).pack(anchor="w", padx=80, pady=3)\n\ntk.Radiobutton(\n root,\n text="Intermediate - I know the basics",\n variable=choice,\n value=2,\n command=show_choice,\n font=("Arial", 11)\n).pack(anchor="w", padx=80, pady=3)\n\ntk.Radiobutton(\n root,\n text="Advanced - I build complex applications",\n variable=choice,\n value=3,\n command=show_choice,\n font=("Arial", 11)\n).pack(anchor="w", padx=80, pady=3)\n\ntk.Radiobutton(\n root,\n text="Expert - I contribute to open source",\n variable=choice,\n value=4,\n command=show_choice,\n font=("Arial", 11)\n).pack(anchor="w", padx=80, pady=3)\n\nresult = tk.Label(root, text="You chose: 1 (value: 1)",\n font=("Arial", 12, "italic"), fg="darkred")\nresult.pack(pady=20)\n\nroot.mainloop()\n\n<\/pre><\/div>\n\nRadiobutton<\/code> widgets share the same choice<\/code> variable. When one is selected, choice.get()<\/code> returns that button’s assigned value. This mutual exclusivity makes radio buttons the right choice for single-option selections like experience level, payment method, or subscription tier.<\/p>\n\n\nFAQ<\/h2>\n\n\n\n
pack()<\/code> places widgets in a single direction – either top-to-bottom (default) or left-to-right. grid()<\/code> places widgets in a table of rows and columns, giving fine control over precise layout. place()<\/code> positions widgets at absolute pixel coordinates. Mix these layout managers within the same application as needed.<\/p>\n\n\n\nPhotoImage<\/code> class for GIF and PNG formats. For other image formats, use the PIL library with ImageTk.PhotoImage<\/code>. Assign the image to a Label widget with label.config(image=photo)<\/code>.<\/p>\n\n\n\ntk.Toplevel()<\/code> windows. These are secondary windows that depend on the main window. When the main window closes, all Toplevel<\/code> windows close as well.<\/p>\n\n\n\n