Table of Contents

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:

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


Table of Contents