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





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 TclGetBoolean.
              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
              TclGetPixels.  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



Tk                                                      iwidgets::extbutton(1)