DragonFly On-Line Manual Pages

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

______________________________________________________________________________

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

SYNOPSIS
       iwidgets::pushbutton pathName ?options?

INHERITANCE
       itk::Widget <- iwidgets::Pushbutton

STANDARD OPTIONS

       activeBackground       activeForeground       background
       bitmap                 borderWidth            command
       cursor                 disabledForeground     font
       foreground             highlightBackground    highlightColor
       highlightThickness     image                  padX
       padY                   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

              Specifies the width 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 width based on the
              requested width plus highlightring and defaultringpad.

______________________________________________________________________________

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

METHODS
       The iwidgets::pushbutton 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:

ASSOCIATED METHODS
       flash           invoke

       See the "button" manual entry for details on the associated 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
              iwidgets::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 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
              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
              iwidgets::pushbutton 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

              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

KEYWORDS
       pushbutton, widget

Tk                                                     iwidgets::pushbutton(1)