Copyright (c) 1995 DSC Technologies Corporation
See the file "license.terms" for information on usage and redistribution
of this file, and for a DISCLAIMER OF ALL WARRANTIES.
@(#) extbutton.n 1.21 01/04/23 16:04:44
.so man.macros .HS iwidgets::extbutton iwid S Note: do not modify the .SH NAME line immediately below!
activebackground activeforeground bitmap
background bd cursor
disabledforeground font foreground
image justify relief text
See the "options" manual entry for details on the standard options.
Name: bitmapforeground Class: Foreground Command-Line Switch: -bitmapforegroundConfigures the foreground color of the bitmap.
Name: command Class: Command Command-Line Switch: -commandAssociate 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: -defaultringBoolean 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: -defaultringpadSpecifies 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: -imageposSpecifies 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: -ringbackgroundConfigures the background color of the default ring frame (if -defaultring is set to boolean true).
E
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.
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: C pathName option ?arg arg ...?
pathName invoke Evaluates the command fragment associated with the -command option.
pathName flash Simulates the Tk button's flash command.