In tkinter, a typical one-line textbox widget is called Entry. In this recipe, we will add such an Entry widget to our GUI. We will make our label more useful by describing what the Entry widget is doing for the user.

This recipe builds upon the Creating buttons and changing their text attributes recipe, so download it from the repository and start working on it.

Follow these steps to create textbox widgets:

1. Start with the GUI_create_button_change_property.py module and save it as GUI_textbox_widget.py.
2. Use the tk alias of tkinter to create a StringVar variable:

name = tk.StringVar()

3. Create a ttk.Entry widget and assign it to another variable:

name_entered = ttk.Entry(win, width=12, textvariable=name)

4. Use this variable to position the Entry widget:

name_entered.grid(column=0, row=1)

The preceding instructions produce the following code (GUI_textbox_widget.py):

5. Run the code and observe the output; our GUI looks like this:

6. Enter some text and click the button; we will see that there is a change in the GUI, which is as follows:

Let's go behind the scenes to understand the code better.

In step 1 we are creating a new Python module, and in step 2 we are adding a StringVar type of tkinter and saving it in the name variable. We use this variable when we are creating an Entry widget and assigning it to the textvariable attribute of the Entry widget. Whenever we type some text into the Entry widget, this text will be saved in the name variable.

In step 4, we position the Entry widget and the preceding screenshot shows the entire code.

In line 24, as shown in the screenshot, we get the value of the Entry widget using name.get().

When we created our button, we saved a reference to it in the action variable. We use the action variable to call the configure method of the button, which then updates the text of our button.

Line 27 gives our label a more meaningful name; for now, it describes the textbox below it. We moved the button down next to the label to visually associate the two. We are still using the grid layout manager, which will be explained in more detail in Chapter 2, Layout Management.

Line 30 creates a variable, name. This variable is bound to the Entry widget and, in our click_me() function, we are able to retrieve the value of the Entry widget by calling get() on this variable. This works like a charm.

Now we observe that while the button displays the entire text we entered (and more), the textbox Entry widget did not expand. The reason for this is that we hardcoded it to a width of 12 in line 31.

We've successfully learned how to create textbox widgets. Now, let's move on to the next recipe.