NAME

       iwidgets::extbutton  - Extends the behavior of the Tk button by allowing a bitmap or image
       to coexist with text.

SYNOPSIS

       iwidgets::extbutton pathName ?options?

INHERITANCE

       itk::Widget <- iwidgets::Extbutton

STANDARD OPTIONS

       activebackground    activeforeground  bitmap
       background          bd                cursor
       disabledforeground  font              foreground
       image               justify           relief      text

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

WIDGET-SPECIFIC OPTIONS

       Name:           bitmapforeground
       Class:          Foreground
       Command-Line Switch:           -bitmapforeground

              Configures the foreground color of the bitmap.

       Name:           command
       Class:          Command
       Command-Line Switch:           -command

              Associate a command with the extbutton. Simulates a Tk  button's  -command  option.
              Invoked by either <1> events or by explicitly calling the public invoke() method.

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

              Boolean  describing whether the extbutton 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 4 pixels.

       Name:   imagePos
       Class:  Position
       Command-Line Switch:    -imagepos

              Specifies the image position relative to the message text: n, ne, nw, s, se, sw, w,
              wn, ws, e, en, or es. The default is w.

       Name:           ringBackground
       Class:          Background
       Command-Line Switch:           -ringbackground

              Configures  the  background color of the default ring frame (if -defaultring is set
              to boolean true).

_________________________________________________________________________________________________

DESCRIPTION

       The extbutton extends the behavior of the atomic Tk button by allowing text and  an  image
       or  bitmap  to coexist. The user may use the -image or -bitmap options to specify an image
       as well as the -imagepos option to specify image position relative to the text.  Note that
       the  extbutton  is not intended to be used without an image/bitmap. There will be an emtpy
       space next to the text if no image/bitmap is specified.

METHODS

       The iwidgets::extbutton 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 ...?

INHERITED METHODS

       Each of the following methods are inherited from itk::Archetype. See  that  man  page  for
       details.  pathName cget pathName component pathName config pathName configure

WIDGET-SPECIFIC METHODS

       pathName invoke
              Evaluates the command fragment associated with the -command option.

       pathName flash
              Simulates the Tk button's flash command.

EXAMPLES

       package require Iwidgets 4.0 iwidgets::extbutton .eb -text "Bitmap example" -bitmap info \
         -background bisque -activeforeground red -bitmapforeground blue \
         -defaultring 1 -command {puts "Bisque is beautiful"} pack .eb -expand 1

       iwidgets::extbutton .eb -text "Image example" -relief ridge -image \
         [image create photo -file $itk::library/../iwidgets/demos/images/clear.gif] \
         -font 9x15bold -background lightgreen -imagepos e \
         -activebackground lightyellow pack .eb -expand 1

AUTHOR

       Chad Smith

KEYWORDS

       button, pushbutton