Tkinter Entry
Summary: in this tutorial, you’ll learn how to use the Tkinter Entry widget to create a textbox.
Introduction to Tkinter Entry widget
The Entry widget allows you to enter a sing-line text. In Tkinter, to create a textbox, you use the Entry widget:
textbox = ttk.Entry(container, **options)Code language: Python (python)
In this syntax:
- The
containeris the parent frame or window. on which you want to place the widget. - The
optionsis one or more keyword arguments used to configure theEntrywidget.
Note that if you want to enter multi-line text, you should use the Text widget.
To get the current text of a Entry widget as a string, you use the get() method:
textbox.get()Code language: Python (python)
Typically, you associate the current value of the textbox with a StringVar object like this:
text = tk.StringVar()
textbox = ttk.Entry(root, textvariable=text)Code language: Python (python)
In this syntax:
- First, create a new instance of the
StringVarclass. The text will be the value holder for a string variable. - Second, assign the text variable to the
textvariableof theEntrywidget.
In this case, you can use call the get() method of the StringVar() object to get the current value of the entry widget:
text.get()Code language: CSS (css)
Setting the focus to the Tkinter Entry widget
To provide a better user experience, you can place move the focus to the first Entry widget after the window appears. Once the Entry widget has focus, it’s ready to accept the user input.
To do it, you use the focus() method of the Entry widget like this:
textbox.focus()Code language: Python (python)
Showing a Tkinter password entry
To hide sensitive information on the Entry widget e.g., a password, you can use the show option.
The following creates a password entry. When you enter a password, it doesn’t show the actual characters but the asterisks (*) specified in the show option:
password = tk.StringVar()
password_entry = ttk.Entry(
root,
textvariable=password,
show='*'
)
password_entry.pack()Code language: Python (python)
Tkinter Entry widget example
The following program shows how to use the Entry widgets to create a sign-in form:
import tkinter as tk
from tkinter import ttk
from tkinter.messagebox import showinfo# root window
root = tk.Tk()
root.geometry("300x150")
root.resizable(False, False)
root.title('Sign In')
# store email address and password
email = tk.StringVar()
password = tk.StringVar()
def login_clicked():
""" callback when the login button clicked
"""
msg = f'You entered email: {email.get()} and password: {password.get()}'
showinfo(
title='Information',
message=msg
)
# Sign in frame
signin = ttk.Frame(root)
signin.pack(padx=10, pady=10, fill='x', expand=True)
# email
email_label = ttk.Label(signin, text="Email Address:")
email_label.pack(fill='x', expand=True)
email_entry = ttk.Entry(signin, textvariable=email)
email_entry.pack(fill='x', expand=True)
email_entry.focus()
# password
password_label = ttk.Label(signin, text="Password:")
password_label.pack(fill='x', expand=True)
password_entry = ttk.Entry(signin, textvariable=password, show="*")
password_entry.pack(fill='x', expand=True)
# login button
login_button = ttk.Button(signin, text="Login", command=login_clicked)
login_button.pack(fill='x', expand=True, pady=10)
root.mainloop()
Code language: Python (python)
Output:
How it works.
First, create two string variables to hold the current text of the email and password Entry widgets:
# store email address and password
email = tk.StringVar()
password = tk.StringVar()Code language: Python (python)
Second, create the email Entry widget and associate it with the email variable:
email_entry = ttk.Entry(signin, textvariable=email)Code language: Python (python)
The following sets focus on the email entry:
email_entry.focus()Code language: Python (python)
Third, create the password entry widget and assign the password variable to its textvariable:
password_entry = ttk.Entry(signin, textvariable=password, show="*")Code language: Python (python)
Finally, display a message box that shows the entered email and password if the login button is clicked.
Summary
- Use the
ttk.Entrywidget to create a textbox. - Use an instance of the
StringVar()class to associate the current text of theEntrywidget with a string variable. - Use the
showoption to create a password entry.