arcadia 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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>