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 iwid-
	      gets::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)