"Fossies" - the Fresh Open Source Software Archive

Member "SAOImageDS9/tk8.6/doc/ttk_spinbox.n" (13 Nov 2019, 4291 Bytes) of package /linux/misc/ds9.8.1.tar.gz:


Caution: As a special service "Fossies" has tried to format the requested manual source page into HTML format but links to other man pages may be missing or even erroneous. Alternatively you can here view or download the uninterpreted manual source code. A member file download can also be achieved by clicking within a package contents listing on the according byte size field.

ttk::spinbox

NAME
SYNOPSIS
DESCRIPTION
WIDGET-SPECIFIC OPTIONS
INDICES
VALIDATION
WIDGET COMMAND
VIRTUAL EVENTS
STYLING OPTIONS
SEE ALSO
KEYWORDS

NAME

ttk::spinbox − Selecting text field widget

SYNOPSIS

ttk::spinbox pathName ?options?

DESCRIPTION

A ttk::spinbox widget is a ttk::entry widget with built-in up and down buttons that are used to either modify a numeric value or to select among a set of values. The widget implements all the features of the ttk::entry widget including support of the −textvariable option to link the value displayed by the widget to a Tcl variable. −class

−cursor

−state

−style −takefocus

−xscrollcommand −validate

−validatecommand

WIDGET-SPECIFIC OPTIONS

[−command command] Specifies a Tcl command to be invoked whenever a spinbutton is invoked. [−format format] Specifies an alternate format to use when setting the string value when using the −from and −to range. This must be a format specifier of the form %<pad>.<pad>f, as it will format a floating-point number. [−from from] A floating−point value specifying the lowest value for the spinbox. This is used in conjunction with −to and −increment to set a numerical range. [−increment increment] A floating−point value specifying the change in value to be applied each time one of the widget spin buttons is pressed. The up button applies a positive increment, the down button applies a negative increment. [−to to] A floating−point value specifying the highest permissible value for the widget. See also −from and −increment. range. [−values values] This must be a Tcl list of values. If this option is set then this will override any range set using the −from, −to and −increment options. The widget will instead use the values specified beginning with the first value. [−wrap wrap] Must be a proper boolean value. If on, the spinbox will wrap around the values of data in the widget.

INDICES

See the ttk::entry manual for information about indexing characters.

VALIDATION

See the ttk::entry manual for information about using the −validate and −validatecommand options.

WIDGET COMMAND

The following subcommands are possible for spinbox widgets in addition to the commands described for the ttk::entry widget:
pathName
get

Returns the spinbox’s current value.

pathName set value

Set the spinbox string to value. If a −format option has been configured then this format will be applied. If formatting fails or is not set or the −values option has been used then the value is set directly.

VIRTUAL EVENTS

The spinbox widget generates a <<Increment>> virtual event when the user presses <Up>, and a <<Decrement>> virtual event when the user presses <Down>.

STYLING OPTIONS

The class name for a ttk::spinbox is TSpinbox.

Dynamic states: active, disabled, focus, readonly.

TSpinbox styling options configurable with ttk::style are:

−arrowcolor color
−arrowsize
amount
−background
color

For backwards compatibility, when using the aqua theme (for macOS), this option behaves as an alias for the −fieldbackground provided that no value is specified for −fieldbackground. Otherwise it is ignored.

−bordercolor color
−darkcolor
color
−fieldbackground
color
−foreground
color
−lightcolor
color
−padding
padding
−selectbackground
color
−selectforeground
color

Some options are only available for specific themes.

See the ttk::style manual page for information on how to configure ttk styles.

SEE ALSO

ttk::widget(n), ttk::entry(n), spinbox(n)

KEYWORDS

entry, spinbox, widget, text field