iwidgets2.2.0 User Commands - spinint






NAME

     spinint - Create and manipulate a integer spinner widget


SYNOPSIS

     spinint pathName ?options?


INHERITANCE

     itk::Widget <- Labeledwidget <- Spinner <- Spinint


STANDARD OPTIONS

     background      borderWidth    cursor          exportSelection
     foreground      highlightColor highlightThicknessinsertBackground
     insertBorderWidth              insertOffTime   insertOnTimeinsertWidth
     justify         relief         selectBackgroundselectBorderWidth
     selectForeground               textVariable

     See the "options" manual entry for details on  the  standard
     options.


ASSOCIATED OPTIONS

     show            state

     See the "entry" manual entry for details on  the  associated
     options.


INHERITED OPTIONS

     command         childSitePos   fixed           focusCommand
     invalid         textBackground textFont        validate
     width

     See the "entryfield" widget manual entry for details on  the
     above inherited options.

     labelBitmap     labelFont      labelImage      labelMargin
     labelPos        labelText      labelVariable

     See the "labeledwidget" widget manual entry for  details  on
     the above inherited options.

     arroworient     decrement      increment       repeatDelay
     repeatInterval

     See the "spinner" widget manual entry  for  details  on  the
     above inherited options.



WIDGET-SPECIFIC OPTIONS

     Name:           range
     Class:          Range
     Command-Line Switch:           -range
          Specifies a two element list  of  minimum  and  maximum
          integer values.  The default is no range, {{} {}}.

     Name:           step
     Class:          Step
     Command-Line Switch:           -step

          Specifies the increment/decrement value.   The  default
          is 1.

     Name:           wrap
     Class:          Wrap
     Command-Line Switch:           -wrap

          Specifies whether to wrap the spinner value upon reach-
          ing  the  minimum  or maximum value in any of the forms
          acceptable to Tcl_GetBoolean.  The default is true.






DESCRIPTION

     The spinint command creates a spinint widget.   The  spinint
     allows "spinning" of integer values within a specified range
     with wrap support.  The spinner arrows may be drawn horizon-
     tally or vertically.




METHODS

     The spinint command creates a new Tcl command whose name  is
     pathName.  This command may be used to invoke various opera-
     tions on the widget.  It has the following general form:

          pathName option ?arg arg ...?

     Option and the args determine the exact behavior of the com-
     mand.  The following commands are possible for spinint widg-
     ets:


ASSOCIATED METHODS

     delete          get            icursor         index
     insert          peek           scan            selection
     xview

     See the "entry" manual entry for details on  the  associated
     methods.


INHERITED METHODS

     childsite       clear


     See the "entryfield" manual entry for details on the associ-
     ated methods.


WIDGET-SPECIFIC METHODS

     pathName cget option
          Returns the current value of the  configuration  option
          given  by  option.   Option  may have any of the values
          accepted by the spinint command.

     pathName configure ?option? ?value option value ...?
          Query  or  modify  the  configuration  options  of  the
          widget.   If  no  option  is  specified, returns a list
          describing all of the available  options  for  pathName
          (see  Tk_ConfigureInfo for information on the format of
          this list).  If option is specified with no value, then
          the  command  returns  a  list describing the one named
          option (this list will be identical to the  correspond-
          ing  sublist  of  the  value  returned  if no option is
          specified).  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.  Option may have any
          of the values accepted by the spinint command.

     pathName down
          Decrement the spinner value by the value given  in  the
          step option.

     pathName up
          Increment the spinner value by the value given  in  the
          step option.



COMPONENTS

          See the "Spinner" widget manual entry  for  details  on
          the integer spinner component items.



EXAMPLE

           option add *textBackground white

           spinint .si -labeltext "Temperature" -labelpos w \
              -fixed yes -width 5 -range {32 212}

           pack .si -pady 10



AUTHOR

     Sue Yockey


KEYWORDS

     spinint, widget