[incr Widgets] - pushbutton manpage





NAME

       pushbutton - Create and manipulate a push button widget


SYNOPSIS

       pushbutton pathName ?options?


INHERITANCE

       itk::Widget <- pushbutton


STANDARD OPTIONS

       activeBackground               activeForegroundbackgroundbitmap
       borderWidth     command        cursor          disabledForeground
       font            foreground     highlightBackgroundhighlightColor
       highlightThickness             image           padXpadY
       state           text           underline       wrapLength

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


WIDGET-SPECIFIC OPTIONS

       Name:           defaultRing
       Class:          DefaultRing
       Command-Line Switch:           -defaultring

              Boolean describing whether the button displays  its
              default  ring  given in any of the forms acceptable
              to Tcl_GetBoolean.  The default is false.

       Name:           defaultRingPad
       Class:          Pad
       Command-Line Switch:           -defaultringpad

              Specifies the amount of space to  be  allocated  to
              the  indentation  of the default ring ring given in
              any of the forms acceptable to Tcl_GetPixels.   The
              option  has  no effect if the defaultring option is
              set to false.  The default is 2 pixels.

       Name:           height
       Class:          Height
       Command-Line Switch:           -height

              Specifies the height of the button inclusive of any
              default  ring  given in any of the forms acceptable
              to Tk_GetPixels.  A value of  zero  lets  the  push
              button  determine the height based on the requested
              height plus highlightring and defaultringpad.

       Name:           width
       Class:          Width
       Command-Line Switch:           -width
              default  ring  given in any of the forms acceptable
              to Tk_GetPixels.  A value of  zero  lets  the  push
              button  determine  the width based on the requested
              width plus highlightring and defaultringpad.

_________________________________________________________________



DESCRIPTION

       The pushbutton command  creates  a  push  button  with  an
       optional  default  ring  used  for default designation and
       traversal.



METHODS

       The pushbutton command creates a  new  Tcl  command  whose
       name is pathName.  This command may be used to invoke var­
       ious operations on the widget.  It has the following  gen­
       eral form:

              pathName option ?arg arg ...?

       Option  and  the  args determine the exact behavior of the
       command.  The following commands are possible for pushbut­
       ton widgets:


ASSOCIATED METHODS

       flash           invoke

       See  the  "button" 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 pushbutton 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  path­
              Name  (see  Tk_ConfigureInfo for information on the
              format of this list).  If option is specified  with
              no  value, then the command returns a list describ­
              ing the one named option (this list will be identi­
              cal  to  the  corresponding  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



COMPONENTS

       Name:           pushbutton
       Class:          Button

              The  pushbutton  component is the button surrounded
              by the optional default  ring.   See  the  "button"
              widget  manual  entry for details on the pushbutton
              component item.



EXAMPLE

              iwidgets::pushbutton .pb -text "Hello" -command {puts "Hello World"} -defaultring 1
              pack .pb -padx 10 -pady 10



AUTHOR

       Bret A. Schuhmacher

       Mark L. Ulferts


KEYWORDS

       pushbutton, widget





























Man(1) output converted with man2html