arcadia 0.1.1 → 0.1.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (167) hide show
  1. data/README +126 -123
  2. data/arcadia.rb +770 -756
  3. data/base/a-contracts.rb +130 -93
  4. data/base/a-ext.rb +280 -280
  5. data/base/a-libs.rb +5 -11
  6. data/base/a-utils.rb +235 -44
  7. data/conf/arcadia.conf +20 -16
  8. data/conf/arcadia.init.rb +0 -0
  9. data/conf/arcadia.res.rb +74 -0
  10. data/ext/ae-complete-code/ae-complete-code.conf +0 -0
  11. data/ext/ae-complete-code/ae-complete-code.rb +80 -79
  12. data/ext/ae-debug/ae-debug.conf +0 -0
  13. data/ext/ae-debug/ae-debug.rb +2 -6
  14. data/ext/ae-debug/debug1.57.rb +0 -0
  15. data/ext/ae-doc-code/ae-doc-code.conf +15 -0
  16. data/ext/ae-doc-code/ae-doc-code.rb +289 -0
  17. data/ext/ae-editor/ae-editor.conf +17 -8
  18. data/ext/ae-editor/ae-editor.rb +738 -396
  19. data/ext/ae-event-log/ae-event-log.conf +0 -0
  20. data/ext/ae-event-log/ae-event-log.rb +0 -0
  21. data/ext/ae-file-history/ae-file-history.conf +2 -2
  22. data/ext/ae-file-history/ae-file-history.rb +286 -290
  23. data/ext/ae-inspector/ae-inspector.conf +0 -0
  24. data/ext/ae-inspector/ae-inspector.rb +0 -0
  25. data/ext/ae-output-event/ae-output-event.conf +2 -2
  26. data/ext/ae-output/ae-output.conf +2 -2
  27. data/ext/ae-output/ae-output.rb +173 -178
  28. data/ext/ae-palette/ae-palette.conf +0 -0
  29. data/ext/ae-palette/ae-palette.rb +0 -0
  30. data/ext/ae-shell/ae-shell.conf +0 -0
  31. data/ext/ae-shell/ae-shell.rb +54 -54
  32. data/lib/tk/al-tk.rb +3076 -3082
  33. data/lib/tk/al-tk.res.rb +0 -0
  34. data/lib/tk/al-tkarcadia.rb +0 -0
  35. data/lib/tk/al-tkcustom.rb +0 -0
  36. data/lib/tkext/al-bwidget.rb +0 -0
  37. data/lib/tkext/al-iwidgets.rb +0 -0
  38. data/lib/tkext/al-tile.rb +0 -0
  39. data/lib/tkext/al-tktable.rb +0 -0
  40. data/tcl/BWidget-1.8.0/BWman/ArrowButton.html +276 -0
  41. data/tcl/BWidget-1.8.0/BWman/BWidget.html +228 -0
  42. data/tcl/BWidget-1.8.0/BWman/Button.html +273 -0
  43. data/tcl/BWidget-1.8.0/BWman/ButtonBox.html +264 -0
  44. data/tcl/BWidget-1.8.0/BWman/ComboBox.html +402 -0
  45. data/tcl/BWidget-1.8.0/BWman/Dialog.html +314 -0
  46. data/tcl/BWidget-1.8.0/BWman/DragSite.html +139 -0
  47. data/tcl/BWidget-1.8.0/BWman/DropSite.html +254 -0
  48. data/tcl/BWidget-1.8.0/BWman/DynamicHelp.html +248 -0
  49. data/tcl/BWidget-1.8.0/BWman/Entry.html +341 -0
  50. data/tcl/BWidget-1.8.0/BWman/Label.html +331 -0
  51. data/tcl/BWidget-1.8.0/BWman/LabelEntry.html +194 -0
  52. data/tcl/BWidget-1.8.0/BWman/LabelFrame.html +144 -0
  53. data/tcl/BWidget-1.8.0/BWman/ListBox.html +678 -0
  54. data/tcl/BWidget-1.8.0/BWman/MainFrame.html +283 -0
  55. data/tcl/BWidget-1.8.0/BWman/MessageDlg.html +218 -0
  56. data/tcl/BWidget-1.8.0/BWman/NoteBook.html +374 -0
  57. data/tcl/BWidget-1.8.0/BWman/PagesManager.html +180 -0
  58. data/tcl/BWidget-1.8.0/BWman/PanedWindow.html +142 -0
  59. data/tcl/BWidget-1.8.0/BWman/PanelFrame.html +153 -0
  60. data/tcl/BWidget-1.8.0/BWman/PasswdDlg.html +214 -0
  61. data/tcl/BWidget-1.8.0/BWman/ProgressBar.html +152 -0
  62. data/tcl/BWidget-1.8.0/BWman/ProgressDlg.html +145 -0
  63. data/tcl/BWidget-1.8.0/BWman/ScrollView.html +130 -0
  64. data/tcl/BWidget-1.8.0/BWman/ScrollableFrame.html +191 -0
  65. data/tcl/BWidget-1.8.0/BWman/ScrolledWindow.html +116 -0
  66. data/tcl/BWidget-1.8.0/BWman/SelectColor.html +164 -0
  67. data/tcl/BWidget-1.8.0/BWman/SelectFont.html +152 -0
  68. data/tcl/BWidget-1.8.0/BWman/Separator.html +77 -0
  69. data/tcl/BWidget-1.8.0/BWman/SpinBox.html +250 -0
  70. data/tcl/BWidget-1.8.0/BWman/StatusBar.html +147 -0
  71. data/tcl/BWidget-1.8.0/BWman/TitleFrame.html +107 -0
  72. data/tcl/BWidget-1.8.0/BWman/Tree.html +947 -0
  73. data/tcl/BWidget-1.8.0/BWman/Widget.html +502 -0
  74. data/tcl/BWidget-1.8.0/BWman/contents.html +84 -0
  75. data/tcl/BWidget-1.8.0/BWman/index.html +7 -0
  76. data/tcl/BWidget-1.8.0/BWman/navtree.html +41 -0
  77. data/tcl/BWidget-1.8.0/BWman/options.htm +458 -0
  78. data/tcl/BWidget-1.8.0/CHANGES.txt +266 -0
  79. data/tcl/BWidget-1.8.0/ChangeLog +1641 -0
  80. data/tcl/BWidget-1.8.0/LICENSE.txt +41 -0
  81. data/tcl/BWidget-1.8.0/README.txt +127 -0
  82. data/tcl/BWidget-1.8.0/arrow.tcl +551 -0
  83. data/tcl/BWidget-1.8.0/bitmap.tcl +94 -0
  84. data/tcl/BWidget-1.8.0/button.tcl +324 -0
  85. data/tcl/BWidget-1.8.0/buttonbox.tcl +403 -0
  86. data/tcl/BWidget-1.8.0/color.tcl +493 -0
  87. data/tcl/BWidget-1.8.0/combobox.tcl +809 -0
  88. data/tcl/BWidget-1.8.0/demo/basic.tcl +199 -0
  89. data/tcl/BWidget-1.8.0/demo/bwidget.xbm +46 -0
  90. data/tcl/BWidget-1.8.0/demo/demo.tcl +212 -0
  91. data/tcl/BWidget-1.8.0/demo/dnd.tcl +42 -0
  92. data/tcl/BWidget-1.8.0/demo/manager.tcl +141 -0
  93. data/tcl/BWidget-1.8.0/demo/select.tcl +59 -0
  94. data/tcl/BWidget-1.8.0/demo/tmpldlg.tcl +214 -0
  95. data/tcl/BWidget-1.8.0/demo/tree.tcl +260 -0
  96. data/tcl/BWidget-1.8.0/demo/x1.xbm +2258 -0
  97. data/tcl/BWidget-1.8.0/dialog.tcl +345 -0
  98. data/tcl/BWidget-1.8.0/dragsite.tcl +197 -0
  99. data/tcl/BWidget-1.8.0/dropsite.tcl +455 -0
  100. data/tcl/BWidget-1.8.0/dynhelp.tcl +625 -0
  101. data/tcl/BWidget-1.8.0/entry.tcl +469 -0
  102. data/tcl/BWidget-1.8.0/font.tcl +566 -0
  103. data/tcl/BWidget-1.8.0/images/bold.gif +0 -0
  104. data/tcl/BWidget-1.8.0/images/copy.gif +0 -0
  105. data/tcl/BWidget-1.8.0/images/cut.gif +0 -0
  106. data/tcl/BWidget-1.8.0/images/dragfile.gif +0 -0
  107. data/tcl/BWidget-1.8.0/images/dragicon.gif +0 -0
  108. data/tcl/BWidget-1.8.0/images/error.gif +0 -0
  109. data/tcl/BWidget-1.8.0/images/file.gif +0 -0
  110. data/tcl/BWidget-1.8.0/images/folder.gif +0 -0
  111. data/tcl/BWidget-1.8.0/images/hourglass.gif +0 -0
  112. data/tcl/BWidget-1.8.0/images/info.gif +0 -0
  113. data/tcl/BWidget-1.8.0/images/italic.gif +0 -0
  114. data/tcl/BWidget-1.8.0/images/minus.xbm +5 -0
  115. data/tcl/BWidget-1.8.0/images/new.gif +0 -0
  116. data/tcl/BWidget-1.8.0/images/opcopy.xbm +5 -0
  117. data/tcl/BWidget-1.8.0/images/open.gif +0 -0
  118. data/tcl/BWidget-1.8.0/images/openfold.gif +0 -0
  119. data/tcl/BWidget-1.8.0/images/oplink.xbm +5 -0
  120. data/tcl/BWidget-1.8.0/images/opmove.xbm +5 -0
  121. data/tcl/BWidget-1.8.0/images/overstrike.gif +0 -0
  122. data/tcl/BWidget-1.8.0/images/palette.gif +0 -0
  123. data/tcl/BWidget-1.8.0/images/passwd.gif +0 -0
  124. data/tcl/BWidget-1.8.0/images/paste.gif +0 -0
  125. data/tcl/BWidget-1.8.0/images/plus.xbm +5 -0
  126. data/tcl/BWidget-1.8.0/images/print.gif +0 -0
  127. data/tcl/BWidget-1.8.0/images/question.gif +0 -0
  128. data/tcl/BWidget-1.8.0/images/redo.gif +0 -0
  129. data/tcl/BWidget-1.8.0/images/save.gif +0 -0
  130. data/tcl/BWidget-1.8.0/images/target.xbm +9 -0
  131. data/tcl/BWidget-1.8.0/images/underline.gif +0 -0
  132. data/tcl/BWidget-1.8.0/images/undo.gif +0 -0
  133. data/tcl/BWidget-1.8.0/images/warning.gif +0 -0
  134. data/tcl/BWidget-1.8.0/init.tcl +40 -0
  135. data/tcl/BWidget-1.8.0/label.tcl +271 -0
  136. data/tcl/BWidget-1.8.0/labelentry.tcl +100 -0
  137. data/tcl/BWidget-1.8.0/labelframe.tcl +160 -0
  138. data/tcl/BWidget-1.8.0/lang/da.rc +52 -0
  139. data/tcl/BWidget-1.8.0/lang/de.rc +52 -0
  140. data/tcl/BWidget-1.8.0/lang/en.rc +52 -0
  141. data/tcl/BWidget-1.8.0/lang/es.rc +53 -0
  142. data/tcl/BWidget-1.8.0/lang/fr.rc +52 -0
  143. data/tcl/BWidget-1.8.0/listbox.tcl +1638 -0
  144. data/tcl/BWidget-1.8.0/mainframe.tcl +711 -0
  145. data/tcl/BWidget-1.8.0/messagedlg.tcl +128 -0
  146. data/tcl/BWidget-1.8.0/notebook.tcl +1164 -0
  147. data/tcl/BWidget-1.8.0/pagesmgr.tcl +294 -0
  148. data/tcl/BWidget-1.8.0/panedw.tcl +381 -0
  149. data/tcl/BWidget-1.8.0/panelframe.tcl +246 -0
  150. data/tcl/BWidget-1.8.0/passwddlg.tcl +178 -0
  151. data/tcl/BWidget-1.8.0/pkgIndex.tcl +47 -0
  152. data/tcl/BWidget-1.8.0/progressbar.tcl +208 -0
  153. data/tcl/BWidget-1.8.0/progressdlg.tcl +87 -0
  154. data/tcl/BWidget-1.8.0/scrollframe.tcl +226 -0
  155. data/tcl/BWidget-1.8.0/scrollview.tcl +254 -0
  156. data/tcl/BWidget-1.8.0/scrollw.tcl +280 -0
  157. data/tcl/BWidget-1.8.0/separator.tcl +75 -0
  158. data/tcl/BWidget-1.8.0/spinbox.tcl +331 -0
  159. data/tcl/BWidget-1.8.0/statusbar.tcl +422 -0
  160. data/tcl/BWidget-1.8.0/tests/entry.test +173 -0
  161. data/tcl/BWidget-1.8.0/titleframe.tcl +170 -0
  162. data/tcl/BWidget-1.8.0/tree.tcl +2228 -0
  163. data/tcl/BWidget-1.8.0/utils.tcl +645 -0
  164. data/tcl/BWidget-1.8.0/widget.tcl +1576 -0
  165. data/tcl/BWidget-1.8.0/wizard.tcl +1028 -0
  166. data/tcl/BWidget-1.8.0/xpm2image.tcl +115 -0
  167. metadata +141 -5
@@ -0,0 +1,402 @@
1
+ <HTML>
2
+ <HEAD><TITLE>ComboBox</TITLE></HEAD>
3
+ <BODY BGCOLOR=white>
4
+ <DL><DT><I><A HREF="#descr">NAME</A></I></DT>
5
+ <DD><B>ComboBox</B>
6
+ - ComboBox widget
7
+ </DD></DL>
8
+ <DL>
9
+ <DT><I>CREATION</I></DT>
10
+ <DD><A HREF="#descr"><B>ComboBox</B></A> <I>pathName</I> ?<I>option value...</I>?</DD>
11
+ </DL>
12
+ <DL>
13
+ <DT><I><A HREF="ArrowButton.html">OPTIONS from <B>ArrowButton</B></A></I></DT>
14
+ <DD><TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0>
15
+ <TR>
16
+ <TD>&nbsp;&nbsp;-background or -bg</TD>
17
+ <TD>&nbsp;&nbsp;-disabledforeground</TD>
18
+ </TR>
19
+ <TR>
20
+ <TD>&nbsp;&nbsp;-foreground or -fg</TD>
21
+ <TD>&nbsp;&nbsp;-state</TD>
22
+ </TR>
23
+ </TABLE></DD>
24
+ </DL>
25
+ <DL>
26
+ <DT><I><A HREF="Entry.html">OPTIONS from <B>Entry</B></A></I></DT>
27
+ <DD><TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0>
28
+ <TR>
29
+ <TD>&nbsp;&nbsp;-command</TD>
30
+ <TD>&nbsp;&nbsp;-disabledforeground</TD>
31
+ </TR>
32
+ <TR>
33
+ <TD>&nbsp;&nbsp;-dragenabled</TD>
34
+ <TD>&nbsp;&nbsp;-dragendcmd</TD>
35
+ </TR>
36
+ <TR>
37
+ <TD>&nbsp;&nbsp;-dragevent</TD>
38
+ <TD>&nbsp;&nbsp;-draginitcmd</TD>
39
+ </TR>
40
+ <TR>
41
+ <TD>&nbsp;&nbsp;-dragtype</TD>
42
+ <TD>&nbsp;&nbsp;-dropcmd</TD>
43
+ </TR>
44
+ <TR>
45
+ <TD>&nbsp;&nbsp;-dropenabled</TD>
46
+ <TD>&nbsp;&nbsp;-dropovercmd</TD>
47
+ </TR>
48
+ <TR>
49
+ <TD>&nbsp;&nbsp;-droptypes</TD>
50
+ <TD>&nbsp;&nbsp;-editable</TD>
51
+ </TR>
52
+ <TR>
53
+ <TD>&nbsp;&nbsp;-entrybg (see <B>-background</B>)</TD>
54
+ <TD>&nbsp;&nbsp;-entryfg (see <B>-foreground</B>)</TD>
55
+ </TR>
56
+ <TR>
57
+ <TD>&nbsp;&nbsp;-exportselection</TD>
58
+ <TD>&nbsp;&nbsp;-font</TD>
59
+ </TR>
60
+ <TR>
61
+ <TD>&nbsp;&nbsp;-helptext</TD>
62
+ <TD>&nbsp;&nbsp;-helptype</TD>
63
+ </TR>
64
+ <TR>
65
+ <TD>&nbsp;&nbsp;-helpvar</TD>
66
+ <TD>&nbsp;&nbsp;-highlightbackground</TD>
67
+ </TR>
68
+ <TR>
69
+ <TD>&nbsp;&nbsp;-highlightcolor</TD>
70
+ <TD>&nbsp;&nbsp;-highlightthickness</TD>
71
+ </TR>
72
+ <TR>
73
+ <TD>&nbsp;&nbsp;-insertbackground</TD>
74
+ <TD>&nbsp;&nbsp;-insertborderwidth</TD>
75
+ </TR>
76
+ <TR>
77
+ <TD>&nbsp;&nbsp;-insertofftime</TD>
78
+ <TD>&nbsp;&nbsp;-insertontime</TD>
79
+ </TR>
80
+ <TR>
81
+ <TD>&nbsp;&nbsp;-insertwidth</TD>
82
+ <TD>&nbsp;&nbsp;-justify</TD>
83
+ </TR>
84
+ <TR>
85
+ <TD>&nbsp;&nbsp;-selectbackground</TD>
86
+ <TD>&nbsp;&nbsp;-selectborderwidth</TD>
87
+ </TR>
88
+ <TR>
89
+ <TD>&nbsp;&nbsp;-selectforeground</TD>
90
+ <TD>&nbsp;&nbsp;-show</TD>
91
+ </TR>
92
+ <TR>
93
+ <TD>&nbsp;&nbsp;-state</TD>
94
+ <TD>&nbsp;&nbsp;-takefocus</TD>
95
+ </TR>
96
+ <TR>
97
+ <TD>&nbsp;&nbsp;-text</TD>
98
+ <TD>&nbsp;&nbsp;-textvariable</TD>
99
+ </TR>
100
+ <TR>
101
+ <TD>&nbsp;&nbsp;-width</TD>
102
+ <TD>&nbsp;&nbsp;-xscrollcommand</TD>
103
+ </TR>
104
+ </TABLE></DD>
105
+ </DL>
106
+ <DL>
107
+ <DT><I><A HREF="#wso">WIDGET-SPECIFIC OPTIONS</A></I></DT>
108
+ <DD><TABLE CELLSPACING=0 CELLSPACING=0 BORDER=0>
109
+ <TR>
110
+ <TD>&nbsp;&nbsp;<A HREF="#-autocomplete">-autocomplete</A></TD>
111
+ <TD>&nbsp;&nbsp;<A HREF="#-autopost">-autopost</A></TD>
112
+ </TR>
113
+ <TR>
114
+ <TD>&nbsp;&nbsp;<A HREF="#-bwlistbox">-bwlistbox</A></TD>
115
+ <TD>&nbsp;&nbsp;<A HREF="#-expand">-expand</A></TD>
116
+ </TR>
117
+ <TR>
118
+ <TD>&nbsp;&nbsp;<A HREF="#-height">-height</A></TD>
119
+ <TD>&nbsp;&nbsp;<A HREF="#-hottrack">-hottrack</A></TD>
120
+ </TR>
121
+ <TR>
122
+ <TD>&nbsp;&nbsp;<A HREF="#-images">-images</A></TD>
123
+ <TD>&nbsp;&nbsp;<A HREF="#-listboxwidth">-listboxwidth</A></TD>
124
+ </TR>
125
+ <TR>
126
+ <TD>&nbsp;&nbsp;<A HREF="#-modifycmd">-modifycmd</A></TD>
127
+ <TD>&nbsp;&nbsp;<A HREF="#-postcommand">-postcommand</A></TD>
128
+ </TR>
129
+ <TR>
130
+ <TD>&nbsp;&nbsp;<A HREF="#-values">-values</A></TD>
131
+ </TR>
132
+ </TABLE></DD>
133
+ </DL>
134
+ <DL>
135
+ <DT><I><A HREF="#wc">WIDGET COMMAND</A></I></DT>
136
+ <DD><I>pathName</I> <A HREF="#bind"><B>bind</B></A>
137
+ ?<I>arg...</I>?
138
+ </DD>
139
+ <DD><I>pathName</I> <A HREF="#cget"><B>cget</B></A>
140
+ <I>option</I>
141
+ </DD>
142
+ <DD><I>pathName</I> <A HREF="#clearvalue"><B>clearvalue</B></A>
143
+ </DD>
144
+ <DD><I>pathName</I> <A HREF="#configure"><B>configure</B></A>
145
+ ?<I>option</I>? ?<I>value</I> <I>option</I> <I>value</I> ...?
146
+ </DD>
147
+ <DD><I>pathName</I> <A HREF="#get"><B>get</B></A></DD>
148
+ <DD><I>pathName</I> <A HREF="#getlistbox"><B>getlistbox</B></A></DD>
149
+ <DD><I>pathName</I> <A HREF="#getvalue"><B>getvalue</B></A></DD>
150
+ <DD><I>pathName</I> <A HREF="#icursor"><B>icursor</B></A>
151
+ <I>index</I>
152
+ </DD>
153
+ <DD><I>pathName</I> <A HREF="#post"><B>post</B></A></DD>
154
+ <DD><I>pathName</I> <A HREF="#setvalue"><B>setvalue</B></A>
155
+ <I>index</I>
156
+ </DD>
157
+ <DD><I>pathName</I> <A HREF="#unpost"><B>unpost</B></A></DD>
158
+ </DL>
159
+ <BR><HR WIDTH="100%"><BR>
160
+ <B><A NAME="descr"></A>DESCRIPTION</B><BR>
161
+ <P>
162
+
163
+ ComboBox widget enables the user to select a value among a list given by
164
+ the <B>values</B> option. The list of possible values can be popped by
165
+ pressing the ArrowButton or by clicking in the entry when <B>editable</B>
166
+ value of the ComboBox is <B>false</B>.<BR> If <B>editable</B> value of the
167
+ ComboBox is <B>true</B> and the entry has the focus, the user can press the
168
+ top and bottom arrow keys to modify its value. If the current value exactly
169
+ match a value in the list, then the previous (for top arrow key) or then
170
+ next (for bottom arrow key) value in the list is displayed. If the current
171
+ value match the beginning of a value in the list, then this value is
172
+ displayed. If the current value doesnt match anything, then the first
173
+ value is displayed.
174
+
175
+ </P>
176
+ <BR><HR WIDTH="50%"><BR>
177
+ <B><A NAME="wso">WIDGET-SPECIFIC OPTIONS</A></B><BR>
178
+ <DL>
179
+ <DT><A NAME="-autocomplete"><B>-autocomplete</B></A></DT>
180
+ <DD>
181
+ Specifies whether or not the combobox should attempt to auto-complete
182
+ the value in the entry field as the user types. If true, the combobox
183
+ will fill in a value that it finds in its value list as the user types
184
+ into the entry.
185
+ </DD>
186
+ </DL>
187
+
188
+ <DL>
189
+ <DT><A NAME="-autopost"><B>-autopost</B></A></DT>
190
+ <DD>
191
+ Specifies whether or not the combobox should post the drop down as
192
+ the user types. If true, the combobox will post and scroll to the
193
+ entry that most closely matches the user entry.
194
+ </DD>
195
+ </DL>
196
+
197
+ <DL>
198
+ <DT><A NAME="-bwlistbox"><B>-bwlistbox</B></A></DT>
199
+ <DD>
200
+ Specifies that the combobox should use a BWidget listbox in its drop
201
+ down instead of the standard Tk option. This option is enabled by
202
+ default if the <b>-images</b> option is not empty.
203
+ </DD>
204
+ </DL>
205
+
206
+ <DL><DT><A NAME="-expand"><B>-expand</B></A></DT>
207
+ <DD>
208
+
209
+ Specifies the value expansion behavior for the window. It must be
210
+ <B>none</B> (default) or <B>tab</B>. If <B>tab</B> is specified, then
211
+ a Tab binding is added to attempt to expand the current value based on
212
+ the other values in <B>-values</B>.
213
+ </DD>
214
+ </DL>
215
+
216
+ <DL><DT><A NAME="-height"><B>-height</B></A></DT>
217
+ <DD>
218
+
219
+ Specifies the desired height for the window, in lines. If zero or less,
220
+ then the desired height for the window is made just large enough to hold
221
+ all the elements in the listbox.
222
+ </DD>
223
+
224
+ <DL>
225
+ <DT><A NAME="-hottrack"><B>-hottrack</B></A></DT>
226
+ <DD>
227
+ The selection in the drop down listbox will follow the mouse cursor
228
+ as it moves.
229
+ </DD>
230
+ </DL>
231
+
232
+ <DL>
233
+ <DT><A NAME="-images"><B>-images</B></A></DT>
234
+ <DD>
235
+ A list of images that correspond to the <b>-values</b> option. Each
236
+ image will be drawn next to its value in the drop down. This option
237
+ enables the <b>-bwlistbox</b> by default as it is needed to display
238
+ images.
239
+ </DD>
240
+ </DL>
241
+
242
+ <DL>
243
+ <DT><A NAME="-listboxwidth"><B>-listboxwidth</B></A></DT>
244
+ <DD>
245
+ Specifies the width of the listbox in the drop down. Defaults to the
246
+ same size as the combobox.
247
+ </DD>
248
+ </DL>
249
+
250
+ </DL>
251
+ <DL><DT><A NAME="-modifycmd"><B>-modifycmd</B></A></DT>
252
+ <DD>
253
+
254
+ Specifies a Tcl command called when the user modify the value of the ComboBox by selecting it in the listbox or pressing arrow key.
255
+ </DD>
256
+ </DL>
257
+ <DL><DT><A NAME="-postcommand"><B>-postcommand</B></A></DT>
258
+ <DD>
259
+
260
+ Specifies a Tcl command called before the listbox of the ComboBox is mapped.
261
+ </DD>
262
+ </DL>
263
+ <DL><DT><A NAME="-values"><B>-values</B></A></DT>
264
+ <DD>
265
+
266
+ Specifies the values to display in the listbox of the ComboBox.
267
+ </DD>
268
+ </DL>
269
+ <HR WIDTH="50%"><BR>
270
+ <B><A NAME="wc">WIDGET COMMAND</A></B><BR>
271
+ <DL><DT><A NAME="bind"><I>pathName</I> <B>bind</B></A>
272
+ ?<I>arg...</I>?
273
+ </DT><DD>
274
+
275
+ Set bindings on the entry widget.
276
+
277
+ </DD></DL>
278
+ <DL><DT><A NAME="cget"><I>pathName</I> <B>cget</B></A>
279
+ <I>option</I>
280
+ </DT><DD>
281
+
282
+ Returns the current value of the configuration option given by <I>option</I>.
283
+ <I>Option</I> may have any of the values accepted by the creation command.
284
+
285
+ </DD></DL>
286
+
287
+ <DL><DT><A NAME="clearvalue"><I>pathName</I> <B>clearvalue</B></A>
288
+ </DT><DD>
289
+
290
+ Clears the current text of the ComboBox.
291
+
292
+ </DD></DL>
293
+
294
+ <DL><DT><A NAME="configure"><I>pathName</I> <B>configure</B></A>
295
+ ?<I>option</I>? ?<I>value</I> <I>option</I> <I>value</I> ...?
296
+ </DT><DD>
297
+
298
+ Query or modify the configuration options of the widget. If no
299
+ <I>option</I> is specified, returns a list describing all of the available
300
+ options for <I>pathName</I>. If <I>option</I> is specified with no
301
+ <I>value</I>, then the command returns a list describing the one named
302
+ <I>option</I> (this list will be identical to the corresponding sublist of
303
+ the value returned if no <I>option</I> is specified). If one or more
304
+ <I>option-value</I> pairs are specified, then the command modifies the
305
+ given widget option(s) to have the given value(s); in this case the command
306
+ returns an empty string. <I>Option</I> may have any of the values accepted
307
+ by the creation command. Read-only options are not be modified.
308
+
309
+ </DD></DL>
310
+
311
+ <DL><DT><A NAME="get"><I>pathName</I> <B>get</B></A>
312
+ </DT><DD>
313
+
314
+ Returns the current contents of the entry.
315
+
316
+ </DD></DL>
317
+
318
+ <DL><DT><A NAME="getlistbox"><I>pathName</I> <B>getlistbox</B></A>
319
+ </DT><DD>
320
+
321
+ Returns the path to the listbox in the drop down.
322
+
323
+ </DD></DL>
324
+
325
+ <DL><DT><A NAME="getvalue"><I>pathName</I> <B>getvalue</B></A>
326
+ </DT><DD>
327
+
328
+ Returns the index of the current text of the ComboBox in the list of values,
329
+ or -1 if it doesn't match any value.
330
+
331
+ </DD></DL>
332
+
333
+ <DL><DT><A NAME="icursor"><I>pathName</I> <B>icursor</B></A>
334
+ <I>index</I>
335
+ </DT><DD>
336
+
337
+ Arrange for the insertion cursor to be displayed just before the
338
+ character given by <i>index</i>. Returns an empty string.
339
+
340
+ </DD></DL>
341
+
342
+ <DL><DT><A NAME="post"><I>pathName</I> <B>post</B></A>
343
+ </DT><DD>
344
+
345
+ Post the drop down.
346
+
347
+ </DD></DL>
348
+
349
+ <DL><DT><A NAME="setvalue"><I>pathName</I> <B>setvalue</B></A>
350
+ <I>index</I>
351
+ </DT><DD>
352
+
353
+ Set the text of the ComboBox to the value indicated by <I>index</I> in the list of values.
354
+ <I>index</I> may be specified in any of the following forms:
355
+ <P>
356
+ <DL COMPACT>
357
+ <DT>
358
+ <B>last</B>
359
+ <DD>
360
+ Specifies the last element of the list of values.
361
+ <DT><B>first</B>
362
+ <DD>
363
+ Specifies the first element of the list of values.
364
+ <DT>
365
+ <B>next</B>
366
+ <DD>
367
+ Specifies the element following the current (ie returned by <B>getvalue</B>) in the list
368
+ of values.
369
+ <DT><B>previous</B>
370
+ <DD>
371
+ Specifies the element preceding the current (ie returned by <B>getvalue</B>) in the list
372
+ of values.
373
+ <DT>
374
+ @<I>number</I>
375
+ <DD>
376
+ Specifies the integer index in the list of values.
377
+ </DL>
378
+
379
+ </DD></DL>
380
+
381
+ <DL><DT><A NAME="unpost"><I>pathName</I> <B>unpost</B></A>
382
+ </DT><DD>
383
+
384
+ Unpost the drop down.
385
+
386
+ </DD></DL>
387
+
388
+ <HR><BR><B>BINDINGS</B><BR><BR>
389
+
390
+ When Entry of the ComboBox has the input focus, it has the following bindings, in addition
391
+ to the default Entry bindings:
392
+ <UL>
393
+ <LI>Page up set the value of the ComboBox to the first value.
394
+ <LI>Page down set the value of the ComboBox to the last value.
395
+ <LI>Arrow up set the value of the ComboBox to the previous value.
396
+ <LI>Arrow down set the value of the ComboBox to the next value.
397
+ <LI>If <B>-autopost</B> is enabled, Escape unposts the listbox.
398
+ </UL>
399
+ If the listbox is not mapped and ComboBox is not editable or disabled,
400
+ mouse button 1 on the Entry cause the listbox to popup, as if the user press the ArrowButton.
401
+
402
+ </BODY></HTML>
@@ -0,0 +1,314 @@
1
+ <HTML>
2
+ <HEAD><TITLE>Dialog</TITLE></HEAD>
3
+ <BODY BGCOLOR=white>
4
+ <DL><DT><I><A HREF="#descr">NAME</A></I></DT>
5
+ <DD><B>Dialog</B>
6
+ - Dialog abstraction with custom buttons
7
+ </DD></DL>
8
+ <DL>
9
+ <DT><I>CREATION</I></DT>
10
+ <DD><A HREF="#descr"><B>Dialog</B></A> <I>pathName</I> ?<I>option value...</I>?</DD>
11
+ </DL>
12
+ <DL>
13
+ <DT><I><A HREF="ButtonBox.html">OPTIONS from <B>ButtonBox</B></A></I></DT>
14
+ <DD><TABLE CELLSPACING=0 CELLPADDING=0 BORDER=0>
15
+ <TR>
16
+ <TD>&nbsp;&nbsp;-background or -bg</TD>
17
+ <TD>&nbsp;&nbsp;-homogeneous</TD>
18
+ </TR>
19
+ <TR>
20
+ <TD>&nbsp;&nbsp;-padx</TD>
21
+ <TD>&nbsp;&nbsp;-pady</TD>
22
+ </TR>
23
+ <TR>
24
+ <TD>&nbsp;&nbsp;-spacing</TD>
25
+ </TABLE></DD>
26
+ </DL>
27
+ <DL>
28
+ <DT><I><A HREF="#wso">WIDGET-SPECIFIC OPTIONS</A></I></DT>
29
+ <DD><TABLE CELLSPACING=0 CELLSPACING=0 BORDER=0>
30
+ <TR>
31
+ <TD>&nbsp;&nbsp;<A HREF="#-anchor">-anchor</A></TR>
32
+ <TD>&nbsp;&nbsp;<A HREF="#-bitmap">-bitmap</A></TR>
33
+ </TR>
34
+ <TR>
35
+ <TD>&nbsp;&nbsp;<A HREF="#-cancel">-cancel</A></TR>
36
+ <TD>&nbsp;&nbsp;<A HREF="#-default">-default</A></TR>
37
+ </TR>
38
+ <TR>
39
+ <TD>&nbsp;&nbsp;<A HREF="#-image">-image</A></TR>
40
+ <TD>&nbsp;&nbsp;<A HREF="#-modal">-modal</A></TR>
41
+ </TR>
42
+ <TR>
43
+ <TD>&nbsp;&nbsp;<A HREF="#-parent">-parent</A></TR>
44
+ <TD>&nbsp;&nbsp;<A HREF="#-place">-place</A></TR>
45
+ </TR>
46
+ <TR>
47
+ <TD>&nbsp;&nbsp;<A HREF="#-separator">-separator</A></TR>
48
+ <TD>&nbsp;&nbsp;<A HREF="#-side">-side</A></TR>
49
+ </TR>
50
+ <TR>
51
+ <TD>&nbsp;&nbsp;<A HREF="#-title">-title</A></TR>
52
+ <TD>&nbsp;&nbsp;<A HREF="#-transient">-transient</A></TR>
53
+ </TR>
54
+ </TABLE></DD>
55
+ </DL>
56
+ <DL>
57
+ <DT><I><A HREF="#wc">WIDGET COMMAND</A></I></DT>
58
+ <DD><I>pathName</I> <A HREF="#add"><B>add</B></A>
59
+ ?<I>arg...</I>?
60
+ </DD>
61
+ <DD><I>pathName</I> <A HREF="#cget"><B>cget</B></A>
62
+ <I>option</I>
63
+ </DD>
64
+ <DD><I>pathName</I> <A HREF="#configure"><B>configure</B></A>
65
+ ?<I>option</I>? ?<I>value</I> <I>option</I> <I>value</I> ...?
66
+ </DD>
67
+ <DD><I>pathName</I> <A HREF="#draw"><B>draw</B></A>
68
+ ?<I>focus</I>?
69
+ </DD>
70
+ <DD><I>pathName</I> <A HREF="#enddialog"><B>enddialog</B></A>
71
+ <I>result</I>
72
+ </DD>
73
+ <DD><I>pathName</I> <A HREF="#getframe"><B>getframe</B></A>
74
+ </DD>
75
+ <DD><I>pathName</I> <A HREF="#invoke"><B>invoke</B></A>
76
+ <I>index</I>
77
+ </DD>
78
+ <DD><I>pathName</I> <A HREF="#itemcget"><B>itemcget</B></A>
79
+ <I>index</I>
80
+ <I>option</I>
81
+ </DD>
82
+ <DD><I>pathName</I> <A HREF="#itemconfigure"><B>itemconfigure</B></A>
83
+ <I>index</I>
84
+ ?<I>option</I>? ?<I>value</I> <I>option</I> <I>value</I> ...?
85
+ </DD>
86
+ <DD><I>pathName</I> <A HREF="#setfocus"><B>setfocus</B></A>
87
+ <I>index</I>
88
+ </DD>
89
+ <DD><I>pathName</I> <A HREF="#withdraw"><B>withdraw</B></A>
90
+ </DD>
91
+ </DL>
92
+ <BR><HR WIDTH="100%"><BR>
93
+ <B><A NAME="descr"></A>DESCRIPTION</B><BR>
94
+ <P>
95
+
96
+ Dialog widget enables the user to create a dialog box.
97
+ Some commands take an <I>index</I> as argument indicating on which
98
+ Button it work. This index is the same specified for equivalent ButtonBox command:
99
+ <P>
100
+ <DL COMPACT>
101
+ <DT>
102
+ <I>number</I>
103
+ <DD>
104
+ Specifies the Button numerically, where 0 corresponds
105
+ to the first added Button, 1 to the next, and so on.
106
+ <DT>
107
+ <B>end</B> or <B>last</B>
108
+ <DD>
109
+ Indicates the last item added.
110
+ <DT><B>default</B>
111
+ <DD>
112
+ Indicates the default Button.
113
+ </DL>
114
+
115
+ </P>
116
+ <BR><HR WIDTH="50%"><BR>
117
+ <B><A NAME="wso">WIDGET-SPECIFIC OPTIONS</A></B><BR>
118
+ <DL><DT><A NAME="-anchor"><B>-anchor (read-only)</B></A></DT>
119
+ <DD>
120
+
121
+ Specifies the anchor point of the ButtonBox.
122
+ Must be one of <B>w</B>, <B>e</B>, <B>n</B>, <B>s</B> or <B>c</B>.
123
+ If <B>side</B> option is set to <I>top</I> or <I>bottom</I>,
124
+ <B>anchor</B> values <I>n</I>, <I>s</I> and <I>c</I> have the same effect.
125
+ If <B>side</B> option is set to <I>left</I> or <I>right</I>,
126
+ <B>anchor</B> values <I>w</I>, <I>e</I> and <I>c</I> have the same effect.
127
+
128
+ </DD>
129
+ </DL>
130
+ <DL><DT><A NAME="-bitmap"><B>-bitmap (read-only)</B></A></DT>
131
+ <DD>
132
+
133
+ Specifies a bitmap to display at the left of the user frame.
134
+ <B>image</B> option override <B>bitmap</B>.
135
+ </DD>
136
+ </DL>
137
+ <DL><DT><A NAME="-cancel"><B>-cancel</B></A></DT>
138
+ <DD>
139
+
140
+ Specifies the number of the cancel button of the Dialog. When user press Esc in the Dialog,
141
+ this button is invoked.
142
+ </DD>
143
+ </DL>
144
+ <DL><DT><A NAME="-default"><B>-default</B></A></DT>
145
+ <DD>
146
+
147
+ Specifies the number of the default button of the Dialog.
148
+ When user press Return in the Dialog, this button is invoked.
149
+ </DD>
150
+ </DL>
151
+ <DL><DT><A NAME="-image"><B>-image (read-only)</B></A></DT>
152
+ <DD>
153
+
154
+ Specifies an image to display at the left of the user frame.
155
+ <B>image</B> option override <B>bitmap</B>.
156
+ </DD>
157
+ </DL>
158
+ <DL><DT><A NAME="-modal"><B>-modal</B></A></DT>
159
+ <DD>
160
+
161
+ This option must be <B>none</B>, <B>local</B> or <B>global</B>. The value of this option
162
+ specifies the grab mode of the dialog and how works Dialog::<B>draw</B>.
163
+
164
+ </DD>
165
+ </DL>
166
+ <DL><DT><A NAME="-parent"><B>-parent</B></A></DT>
167
+ <DD>
168
+
169
+ Parent of the Dialog. Dialog is placed relative to its parent. If empty, it is
170
+ placed relative to the root window. Also see <B>place</B> option.
171
+
172
+ </DD>
173
+ </DL>
174
+ <DL><DT><A NAME="-place"><B>-place</B></A></DT>
175
+ <DD>
176
+ Specifies where to draw the Dialog toplevel relative to the dialog's
177
+ parent. Must be one of <B>none</B>, <B>center</B>, <B>left</B>, <B>right</B>,
178
+ <B>above</B>, <B>below</B>. Default value of <B>place</B> is <I>center</I>.
179
+
180
+ </DD>
181
+ </DL>
182
+ <DL><DT><A NAME="-separator"><B>-separator (read-only)</B></A></DT>
183
+ <DD>
184
+
185
+ Specifies wether or not to draw a separator between the user frame and the ButtonBox.
186
+
187
+ </DD>
188
+ </DL>
189
+ <DL><DT><A NAME="-side"><B>-side (read-only)</B></A></DT>
190
+ <DD>
191
+
192
+ Specifies where to draw the ButtonBox relative to the user frame. Must be one of
193
+ <B>top</B>, <B>left</B>, <B>bottom</B> or <B>right</B>.
194
+ </DD>
195
+ </DL>
196
+ <DL><DT><A NAME="-title"><B>-title</B></A></DT>
197
+ <DD>
198
+
199
+ Title of the Dialog toplevel.
200
+
201
+ </DD>
202
+ </DL>
203
+ <DL><DT><A NAME="-transient"><B>-transient (read-only)</B></A></DT>
204
+ <DD>
205
+
206
+ Specifies if the Dialog Toplevel should be a transient window or not. Default
207
+ value of <B>transient</B> is <I>true</I>.
208
+
209
+ </DD>
210
+ </DL>
211
+ <HR WIDTH="50%"><BR>
212
+ <B><A NAME="wc">WIDGET COMMAND</A></B><BR>
213
+ <DL><DT><A NAME="add"><I>pathName</I> <B>add</B></A>
214
+ ?<I>arg...</I>?
215
+ </DT><DD>
216
+
217
+ Add a button to the button box of the dialog box. Default -command option is
218
+ <I>Dialog::enddialog $path index</I> where <I>index</I> is number of button added.
219
+ </DD></DL>
220
+ <DL><DT><A NAME="cget"><I>pathName</I> <B>cget</B></A>
221
+ <I>option</I>
222
+ </DT><DD>
223
+
224
+ Returns the current value of the configuration option given by <I>option</I>.
225
+ <I>Option</I> may have any of the values accepted by the creation command.
226
+ </DD></DL>
227
+ <DL><DT><A NAME="configure"><I>pathName</I> <B>configure</B></A>
228
+ ?<I>option</I>? ?<I>value</I> <I>option</I> <I>value</I> ...?
229
+ </DT><DD>
230
+
231
+ Query or modify the configuration options of the widget. If no <I>option</I> is specified,
232
+ returns a list describing all of the available options for <I>pathName</I>.
233
+ If <I>option</I> is specified with no <I>value</I>, then the command returns a list
234
+ describing the one named <I>option</I> (this list will be identical to the corresponding
235
+ sublist of the value returned if no <I>option</I> is specified). If one or
236
+ more <I>option-value</I> pairs are specified, then the command modifies the given widget
237
+ option(s) to have the given value(s); in this case the command returns an empty string.
238
+ <I>Option</I> may have any of the values accepted by the creation command.
239
+ Read-only options are not be modified.
240
+
241
+ </DD></DL>
242
+ <DL><DT><A NAME="draw"><I>pathName</I> <B>draw</B></A>
243
+ ?<I>focus</I>?
244
+ </DT><DD>
245
+
246
+ This command draw the Dialog, and set grab to it following <B>modal</B> option.
247
+ If <B>modal</B> option is set to <I>none</I>, the command returns immediatly
248
+ an empty string. In all other case, the command returns when Dialog::<B>enddialog</B>
249
+ is called or when Dialog is destroyed.
250
+ The return value is the result argument of Dialog::<B>enddialog</B> or -1 if it is destroyed.
251
+ <P>
252
+ By default, the focus is set to the default button referenced by <B>default</B> option,
253
+ or to the toplevel of Dialog if no default button has been set.
254
+ If <I>focus</I> is present, it must be a pathname, or an index to a button.
255
+ Initial focus is set on this pathname or corresponding button.
256
+
257
+ </DD></DL>
258
+ <DL><DT><A NAME="enddialog"><I>pathName</I> <B>enddialog</B></A>
259
+ <I>result</I>
260
+ </DT><DD>
261
+
262
+ This command is typically called within a command of a button to make Dialog::<B>draw</B>
263
+ return.
264
+
265
+ </DD></DL>
266
+ <DL><DT><A NAME="getframe"><I>pathName</I> <B>getframe</B></A>
267
+ </DT><DD>
268
+
269
+ Returns the pathname of the user window.
270
+ </DD></DL>
271
+ <DL><DT><A NAME="invoke"><I>pathName</I> <B>invoke</B></A>
272
+ <I>index</I>
273
+ </DT><DD>
274
+
275
+ Invoke the Button given by <I>index</I>.
276
+
277
+ </DD></DL>
278
+ <DL><DT><A NAME="itemcget"><I>pathName</I> <B>itemcget</B></A>
279
+ <I>index</I>
280
+ <I>option</I>
281
+ </DT><DD>
282
+
283
+ Returns the current value of a configuration option for the item.
284
+ <I>Option</I> may have any of the values accepted by the item creation command.
285
+
286
+ </DD></DL>
287
+ <DL><DT><A NAME="itemconfigure"><I>pathName</I> <B>itemconfigure</B></A>
288
+ <I>index</I>
289
+ ?<I>option</I>? ?<I>value</I> <I>option</I> <I>value</I> ...?
290
+ </DT><DD>
291
+
292
+ This command is similar to the <B>configure</B> command, except that it applies to the
293
+ options for an individual item, whereas <B>configure</B> applies to the options for
294
+ the widget as a whole. <B>Options</B> may have any of the values accepted by the
295
+ item creation widget command. If options are specified, options are modified as indicated
296
+ in the command and the command returns an empty string. If no options are specified,
297
+ returns a list describing the current options for the item.
298
+ Read-only options are not be modified.
299
+
300
+ </DD></DL>
301
+ <DL><DT><A NAME="setfocus"><I>pathName</I> <B>setfocus</B></A>
302
+ <I>index</I>
303
+ </DT><DD>
304
+
305
+ Set the focus to the Button given by <I>index</I>.
306
+
307
+ </DD></DL>
308
+ <DL><DT><A NAME="withdraw"><I>pathName</I> <B>withdraw</B></A>
309
+ </DT><DD>
310
+
311
+ Call this command to hide the dialog box.
312
+
313
+ </DD></DL>
314
+ </BODY></HTML>