New Tutorials:   TKINTER    KOTLIN    JAVASCRIPT    SASS/SCSS    PL/SQL    Matplotlib    C++ Programs
See the Tutorial List

Python Tkinter Spinbox Widget

In this tutorial, we will cover Tkinter Spinbox widget in Python with its syntax and few examples. The Spinbox widget in Tkinter in Python is used to select a value from the specified given range of values.

It is different from the Tkinter Scale widget (Scale widget being more stylish) in terms of style, but more or less, fulfils the same purpose.

For example, when you want to have a dropdown of numerical values like year of birth (from 1950 to 2020) or a dropdown for user to choose their age, we can use the Tkinter Spinbox widget.

  • This widget is an alternative to Entry widget, when we want user to enter a numeric value within a specific range.

  • This widget is used only in the case where users need to chose from a given range of choices.

Tkinter Spinbox Widget

The syntax of the Spinbox widget is given below:

w = Spinbox(master, option=value)

In the above syntax, the master parameter denotes the parent window. You can use many options to configure your spinbox widget and these options are written as comma-separated key-value pairs.

Tkinter Spinbox Widget Options:

Following are the various options used with Tkinter Spinbox widgets:

Name of the Option Description
bg This option is used for the background color of the widget.
bd This option is used for the border width of the widget
command This option is used to indicate the associated function with the widget which is called every time the state of the widget is changed.
cursor With the help of this option, your mouse pointer type can be changed to the cursor type that is assigned to this option.
activebackground This option indicates the background color of the widget when it is under the focus
disabledbackground This option is used to indicate the background color of the widget when it is disabled.
disabledforeground This option is used to indicate the foreground color of the widget when it is disabled.
font This option specifies the font type of text inside the widget.
fg This option specifies the foreground color of the widget.
format This option is mainly used for the format string. There is no default value of this option.
from_ This option is used to indicate the starting range of the widget
justify This option specifies the alignment of multiple lines in the label. The default value is LEFT. Other values are RIGHT and CENTER.
relief This option indicates the type of border. The default value of this option is SUNKEN.
state This option is used to represent the state of the widget. The default value of this option is NORMAL. Other values are "DISABLED", "read-only", etc.
validate This option is used to control how to validate the value of the widget
to This option represents the maximum limit of the widget value. The other value is specified by the from_ option
repeatdelay This option is mainly used to control the autorepeat button. The value here is in milliseconds.
repeatinterval This option is similar to repeatdelay option. The value here is also given in milliseconds.
validatecommand This option is associated with the function callback that is used for the validation of the content of the widget.
xscrollcommand This option is mainly used with the set() method of the scrollbar widget to make this widget horizontally scrollable
wrap This option is mainly used to wrap-up the up and down button of the Spinbox
width This option indicates the width of the widget.
vcmd This option is similar to validatecommand.
values This option represents the tuple which contains the values for the widget
textvariable It is a control variable that is used to control the text of the widget

Tkinter Spinbox Widget Methods:

Following are the various methods used with Tkinter Spinbox widget:

Method Name Description
invoke(element) This method is used to invoke the callback that is associated with the widget.
insert(index,string) We use this method mainly to insert the string at the given specified index
index(index) To get the absolute value of the given index this method will be used
identify(x,y) This method is used to identify the widget's element in the specified range
get(startindex, endindex) This method is used to get the characters in the specified range
delete(startindex, endindex) This method is used to delete the characters in the specified range

Tkinter Spinbox Widget Example

Below we have a basic example of the Spinbox widget. Let us see the code snippet given below:

from tkinter import *

win = Tk() 
win.geometry("300x200") 

w = Label(win, text ='StudyTonight', fg="navyblue",font = "50") 
w.pack() 

sp = Spinbox(win, from_= 0, to = 50) 
sp.pack() 

win.mainloop() 


In the above code, we created a simple application window, with a Label widget and a Spinbox widget with range from 0 to 50.

Summary:

So this how a TKinter Spinbox widget works. It is used for creating input for a specified range of numeric values, which user can select. If we have a defined range of numbers then its better to use the Spinbox widget rather than using a Tkinter Entry widget.