1iwidgets::extbutton  −  Extends  the behavior of the Tk button by
2allowing  a  bitmap  or  image  to  coexist  with  text.    iwid‐

gets::extbutton pathName ?options? itk::Widget <‐ iwid‐

4gets::Extbutton

activebackground activeforeground bitmap

background bd cursor

disabledforeground font foreground

image justify relief text

9See the "options" manual entry for details on  the  standard  op‐
10tions.
11Name:           bitmapforeground
12Class:          Foreground
13Command‐Line Switch:           ‐bitmapforeground
14Configures the foreground color of the bitmap.
15Name:           command
16Class:          Command
17Command‐Line Switch:           ‐command
18Associate  a  command with the extbutton. Simulates a Tk button’s
19‐command option. Invoked by either <1> events  or  by  explicitly
20calling the public invoke() method.
21Name:   defaultring
22Class:  DefaultRing
23Command‐Line Switch:    ‐defaultring
24Boolean  describing  whether  the  extbutton displays its default
25ring given in any of the forms acceptable to Tcl_GetBoolean.  The
26default is false.
27Name:   defaultringpad
28Class:  Pad
29Command‐Line Switch:    ‐defaultringpad
30Specifies  the amount of space to be allocated to the indentation
31of the default ring ring given in any of the forms acceptable  to

Tcl_GetPixels. The option has no effect if the defaultring op‐

33tion is set to false.  The default is 4 pixels.
34Name:   imagePos
35Class:  Position
36Command‐Line Switch:    ‐imagepos
37Specifies 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.

39Name:           ringBackground
40Class:          Background
41Command‐Line Switch:           ‐ringbackground
42Configures  the  background  color  of the default ring frame (if
43‐defaultring is set to boolean true).
44
45The extbutton extends the behavior of the atomic Tk button by al‐
46lowing  text  and an image or bitmap to coexist. The user may use
47the ‐image or ‐bitmap options to specify an image as well as  the
48‐imagepos  option to specify image position relative to the text.
49Note that the extbutton is not intended to be used without an im‐
50age/bitmap.  There  will be an emtpy space next to the text if no
51image/bitmap is specified.
52
53The iwidgets::extbutton command creates a new Tcl  command  whose
54name is pathName.  This command may be used to invoke various op‐
55erations on the widget.  It has the following general form: path‐

Name option ?arg arg ...?

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

pathName config pathName configure

61

pathName invoke Evaluates the command fragment associated with

63the ‐command option.  pathName flash Simulates  the  Tk  button’s
64flash command.
65
66package  require Iwidgets 4.0 iwidgets::extbutton .eb ‐text "Bit‐
67map example" ‐bitmap info \
68  ‐background bisque ‐activeforeground red ‐bitmapforeground blue
69\
70  ‐defaultring  1  ‐command {puts "Bisque is beautiful"} pack .eb
71‐expand 1
72
73iwidgets::extbutton .eb ‐text "Image example" ‐relief ridge  ‐im‐
74age \
75  [image  create  photo ‐file $itk::library/../iwidgets/demos/im‐
76ages/clear.gif] \
77  ‐font 9x15bold ‐background lightgreen ‐imagepos e \
78  ‐activebackground lightyellow pack .eb  ‐expand  1  Chad  Smith
79button, pushbutton
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132