hwtk::spinbox
An edit field containing a number, with up and down errors on the right-hand side, which allows the user to increase/decrease the number by a given increment.
Format
hwtk::spinbox - pathName ?option value? …
Standard Options
- -clientdata
- Database name: clientData
- -cursor
- Database name: cursor
- -help
- Database name: help
- -helpcommand
- Database name: helpcommand
- -marker
- Database name: marker
- -state
- Database name: state
- -takefocus
- Database name: takeFocus
- -textvariable
- Database name: textVariable
- -width
- Database name: width
Widget Specific Options
- -command
- Database name: command
- -format
- Database name: format
- -from
- Database name: from
- -increment
- Database name: increment
- -inputtype
- Database name: inputtype
- -invalidcommand
- Database name: invalidCommand
- -justify
- Database name: justify
- -show
- Database name: show
- -to
- Database name: to
- -validate
- Database name: validate
- -validatecommand
- Database name: validateCommand
- -values
- Database name: values
- -wrap
- Database name: wrap
Widget Commands
- pathName configure ?option? ?value option value …?
- Query or modify the configuration options of the widget. If one or more option-value pairs are specified, then the command modifies the given widget option(s) to have the given value(s); in this case the command returns an empty string. If option is specified with no value, then the command returns a list describing the named option: the elements of the list are the option name, database name, database class, default value, and current value. If no option is specified, returns a list describing all of the available options for pathName.
- pathName cget option
- Returns the current value of the configuration option given by option.
- pathName identify element x y
- Returns the name of the element under the point given by x and y, or an empty string if the point does not lie within any element. x and y are pixel coordinates relative to the widget. Some widgets accept other identify subcommands.
- pathName instate statespec ?script?
- Test the widget’s state. If script is not specified, returns 1 if the
widget state matches statespec and 0 otherwise. If script is specified,
equivalent to
if{[pathNameinstatestateSpec]}script
- pathName state ?stateSpec?
- Modify or inquire widget state. If stateSpec is
present, sets the widget state: for each flag in
stateSpec, sets the corresponding flag or clears it
if prefixed by an exclamation point. Returns a new state spec indicating
which flags were changed:
will restore pathName to the original state. If stateSpec is not specified, returns a list of the currently-enabled state flags.setchanges[pathNamestatespec]
pathNamestate$changes
- pathName bbox index
- Returns a list of four numbers describing the bounding box of the character given by index. The first two elements of the list give the x and y coordinates of the upper-left corner of the screen area covered by the character (in pixels relative to the widget) and the last two elements give the width and height of the character, in pixels. The bounding box may refer to a region outside the visible area of the window.
- pathName delete firstIndex ?arg arg …?
- Delete one or more elements of the spinbox. firstIndex is the index of the first item to delete. This command returns the empty string.
- pathName get
- Returns the spinbox’s string.
- pathName icursor index
- Arrange for the insert cursor to be displayed just before the character given by index. Returns the empty string.
- pathName index string
- Returns the index of value.
- pathName insert ?arg arg …?
- Insert value just before the character indicated by insert. Returns the empty string.
- pathName selection option arg
- This command is used to adjust the selection within an entry. It has
several forms, depending on option:
- pathName selection clear
- Clear the selection if it is currently in this widget. If the selection isn’t in this widget then the command has no effect. Returns the empty string.
- pathName selection present
- Returns 1 if there is are characters selected in the entry, 0 if nothing is selected.
- pathName selection range start end
- Sets the selection to include the characters starting with the one indexed by start and ending with the one just before end. If end refers to the same character as start or an earlier one, then the entry’s selection is cleared.
- pathName set ?arg arg …?
- Sets the entry’s value to arg.
- pathName xview args
- This command is used to query and change the horizontal position of the
text in the widget’s window. It can take any of the following forms:
- pathName xview
- Returns a list containing two elements. Each element is a real fraction between 0 and 1; together they describe the horizontal span that is visible in the window. For example, if the first element is .2 and the second element is .6, 20% of the entry’s text is offscreen to the left, the middle 40% is visible in the window, and 40% of the text is offscreen to the right. These are the same values passed to scrollbars via the -xscrollcommand option.
- pathName xview index
- Adjusts the view in the window so that the character given by index is displayed at the left edge of the window.
- pathName xview moveto fraction
- Adjusts the view in the window so that the character fraction of the way through the text appears at the left edge of the window. fraction must be a fraction between 0 and 1.
- pathName xview scroll number what
- This command shifts the view in the window left or right according to number and what. Number must be an integer. What must be either units or pages. If what is units, the view adjusts left or right by number average width characters on the display; if it is pages then the view adjusts by number screenfuls. If number is negative then characters farther to the left become visible; if it is positive then characters farther to the right become visible.
Example
::hwtk::dialog .d -title "::hwtk::spinbox"
set sb [hwtk::spinbox [.d recess] .sb]
pack $sb -pady 4 -padx 4
$sb configure -inputtype integer
$sb configure -from 0
$sb configure -to 50
set sb2 [hwtk::spinbox [.d recess] .sb2]
pack $sb2 -pady 4 -padx 4
$sb configure -inputtype alphabetic
$sb configure -values [list Vienna Berlin Rome London]
.d post