Nictk 2.2.0
An easy to use pyton GUI
Spinbox Class Reference

Spinbox widget, which allows to choose from a list of strings or type one. More...

Inheritance diagram for Spinbox:
Widget Misc

Public Member Functions

def __init__ (self, parent, x, y, w, h, pad=0, limits=None, variable=None, command=None)
 The constructor. More...
 
def mode (self, mode, wrap=None, validate=None)
 Sets the spinbox mode to one of these three: More...
 
- Public Member Functions inherited from Widget
def activate (self)
 Sets the state of the widget to NORMAL. More...
 
def deactivate (self)
 Sets the state of the widget to DISABLED. More...
 
def destroy (self)
 Overrides the BaseWidget method, unmapping the widget if its parent is a _embedVerFrame. More...
 
def enabled (self)
 Returns True if the widget is enabled. More...
 
def get_content (self)
 Returns the content of the widget as a string. More...
 
def hide (self)
 Hides the widget. More...
 
def init_content (self, content)
 Sets the content type for the widget. More...
 
def resize (self, x=None, y=None, w=None, h=None, pad=None)
 Changes the dimensions of the widget. More...
 
def set_content (self, content)
 Sets the content of the widget. More...
 
def show (self)
 Shows a previously hidden widget. More...
 
def visible (self)
 Returns True if the widget is visible. More...
 
- Public Member Functions inherited from Misc
def bind (self, sequence=None, func=None, add=None)
 Redefines the tk.Misc.bind() method. More...
 
def config (self, cnf=None, **kw)
 Configures resources of a widget. More...
 
def get_config (self, key)
 Returns the value for the key resource. More...
 
def get_winfo (self, key)
 Returns the widget info for the item key. More...
 
def has_option (self, opt=None)
 Returns True if the widget admits the given option. More...
 
def parent (self)
 Returns the widget parent. More...
 
def toplevel (self)
 Returns the widget toplevel container (a Window or Main). More...
 
def unbind (self, sequence, funcid=None)
 Redefines the tk.Misc.unbind() method. More...
 
def winfo_bh (self)
 Returns the height of the widget bounding box. More...
 
def winfo_bpad (self)
 Returns the list of the four pad amounts (E-N-W-S) of the widget with respect to its bounding box. More...
 
def winfo_bw (self)
 Returns the width of the widget bounding box. More...
 
def winfo_bx (self)
 Returns the x coordinate of the widget bounding box topleft corner. More...
 
def winfo_by (self)
 Returns the y coordinate of the widget bounding box topleft corner. More...
 
def winfo_height (self)
 Returns the widget height. More...
 
def winfo_width (self)
 Returns the widget width. More...
 
def winfo_x (self)
 Returns the x coordinate of the topleft corner of the widget with respect to the parent. More...
 
def winfo_y (self)
 Returns the y coordinate of the topleft corner of the widget with respect to the parent. More...
 

Additional Inherited Members

- Static Public Attributes inherited from Misc
def winfo_h = winfo_height
 Alias for winfo_height() More...
 
def winfo_w = winfo_width
 Alias for winfo_width() More...
 

Detailed Description

Spinbox widget, which allows to choose from a list of strings or type one.

You can set it in a readonly state for disabling typing into it and enable the autoadd feature, which automatically adds to the item list every string you type. You can associate a StringVar to its value and a callback to be called when the the user changes his choice.

Common options (see Widgets properties)

 abcolor, bcolor, borderwidth, command, cursor, dbcolor,
 dfcolor, font, fcolor, hbcolor, hborder, hfcolor, ibcolor,
 justify, rbcolor, relief, sbcolor, sfcolor, state, takefocus,
 textvariable

Less common options

 buttonbackground, buttoncursor, buttondownrelief,
 buttonuprelief, exportselection, format, from,
 insertborderwidth, insertofftime, insertontime, insertwidth,
 invalidcommand, increment, repeatdelay,  repeatinterval,
 selectborderwidth, to, validate, validatecommand values,
 xscrollcommand, wrap

see anzeljg reference for the class tkinter.Spinbox

See also
Spinbox.py example file

Constructor & Destructor Documentation

◆ __init__()

def __init__ (   self,
  parent,
  x,
  y,
  w,
  h,
  pad = 0,
  limits = None,
  variable = None,
  command = None 
)

The constructor.

You can specify here the admitted values for the spinbox, a Variable object which will be updated when the state changes and a callback to associate to the choice event.

Parameters
parentthe widget parent
x,y,w,h,padsee Placing the widgets
limitsthe admitted values; here you can specify
  • a list of strings
  • a duple of int or float (the min and max)
  • a triple of int or float (min, max and step)
variablethe StringVar object whose value is associated with the choosen item (numbers are converted into strings); if you leave None an internal StringVar is created
commandsee Events and callbacks

Reimplemented from Widget.

Member Function Documentation

◆ mode()

def mode (   self,
  mode,
  wrap = None,
  validate = None 
)

Sets the spinbox mode to one of these three:

  • "normal" you can get the content by clicking the arrow keys or typing in the texr field
  • "readonly": you can only click the arrow key
  • "autoadd": (only if values are string) as normal, but inserts every new typed word into the list

The documentation for this class was generated from the following file: