|
ActiveTcl User Guide |
 |
extbutton - Extends the behavior of the Tk button
SYNOPSIS
extbutton pathName ?options?
INHERITANCE
itk::Widget <- extbutton
STANDARD OPTIONS
activebackground
bd
foreground
text
|
activeforeground
cursor
image
|
bitmap
disabledforeground
justify
|
background
font
relief
|
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 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
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
|
