iwidgets::pushbutton(1) [incr Widgets] iwidgets::pushbutton(1)

NAME
       iwidgets::pushbutton - Create and manipulate a push button widget

SYNOPSIS
       iiwwiiddggeettss::::ppuusshhbbuuttttoonn pathName ?options?

IINNHHEERRIITTAANNCCEE
       itk::Widget <- iwidgets::Pushbutton

SSTTAANNDDAARRDD OOPPTTIIOONNSS
       aaccttiivveeBBaacckkggrroouunndd       aaccttiivveeFFoorreeggrroouunndd       bbaacckkggrroouunndd
       bbiittmmaapp                 bboorrddeerrWWiiddtthh            ccoommmmaanndd
       ccuurrssoorr                 ddiissaabblleeddFFoorreeggrroouunndd     ffoonntt
       ffoorreeggrroouunndd             hhiigghhlliigghhttBBaacckkggrroouunndd    hhiigghhlliigghhttCCoolloorr
       hhiigghhlliigghhttTThhiicckknneessss     iimmaaggee                  ppaaddXX
       ppaaddYY                   ssttaattee                  tteexxtt
       uunnddeerrlliinnee              wwrraappLLeennggtthh

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

WWIIDDGGEETT-SSPPEECCIIFFIICC OOPPTTIIOONNSS
       Name:           ddeeffaauullttRRiinngg
       Class:          DDeeffaauullttRRiinngg
       Command-Line Switch:           -ddeeffaauullttrriinngg

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

       Name:           ddeeffaauullttRRiinnggPPaadd
       Class:          PPaadd
       Command-Line Switch:           -ddeeffaauullttrriinnggppaadd

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

       Name:           hheeiigghhtt
       Class:          HHeeiigghhtt
       Command-Line Switch:           -hheeiigghhtt

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

       Name:           wwiiddtthh
       Class:          WWiiddtthh
       Command-Line Switch:           -wwiiddtthh

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




DESCRIPTION
       The iiwwiiddggeettss::::ppuusshhbbuuttttoonn command creates a push button with an optional
       default ring used for default designation and traversal.


MMEETTHHOODDSS
       The  iiwwiiddggeettss::::ppuusshhbbuuttttoonn  command creates a new Tcl command whose name
       is pathName.  This command may be used to invoke various operations  on
       the widget.  It has the following general form:

              pathName option ?arg arg ...?

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

AASSSSOOCCIIAATTEEDD MMEETTHHOODDSS
       ffllaasshh           iinnvvookkee

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


WWIIDDGGEETT-SSPPEECCIIFFIICC MMEETTHHOODDSS
       pathName ccggeett option
              Returns the current value of the configuration option  given  by
              option.  Option may have any of the values accepted by the iiwwiidd-
              ggeettss::::ppuusshhbbuuttttoonn command.

       pathName ccoonnffiigguurree ?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 avail-
              able options for pathName (see TTkkCCoonnffiigguurreeIInnffoo 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 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 returns an empty string.  Option may have any
              of the values accepted by the iiwwiiddggeettss::::ppuusshhbbuuttttoonn command.


CCOOMMPPOONNEENNTTSS
       Name:           ppuusshhbbuuttttoonn
       Class:          BBuuttttoonn

              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.


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


AUTHOR       Bret A. Schuhmacher

       Mark L. Ulferts

KKEEYYWWOORRDDSS
       pushbutton, widget



Tk                                                     iwidgets::pushbutton(1)