Commit | Line | Data |
---|---|---|
8704bf74 JS |
1 | |
2 | ||
3 | ||
4 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
5 | ||
6 | ||
7 | N\bNA\bAM\bME\bE | |
8 | XmComboBox - The Combo Box widget class | |
9 | ||
10 | S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS | |
11 | #\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<C\bCo\bom\bmb\bbo\boB\bBo\box\bx.\b.h\bh>\b> | |
12 | ||
13 | Depending on your system's configuration the place of this | |
14 | include file may vary. In doubt, contact your local system | |
15 | administrator. Or run in circles and shout. | |
16 | ||
17 | ||
18 | D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN | |
19 | The ComboBox widget allows the user to select elements | |
20 | from a list of choices, and enter their own values in a | |
21 | text widget. To conserve screen space, the list of choices | |
22 | is shown only when the user selects the down arrow button. | |
23 | The choices may then be selected from this list. The list | |
24 | will automatically by removed when the user selects an | |
25 | item in the list. When the list is removed, the item that | |
26 | was selected will be placed in the text widget. Typing the | |
27 | escape key when the list is up, cancels the list popup. | |
28 | ||
29 | C\bCl\bla\bas\bss\bse\bes\bs | |
30 | ComboBox inherits behaviour and resources from C\bCo\bor\bre\be and | |
31 | C\bCo\bom\bmp\bpo\bos\bsi\bit\bte\be, C\bCo\bon\bns\bst\btr\bra\bai\bin\bnt\bt and X\bXm\bmM\bMa\ban\bna\bag\bge\ber\br classes. | |
32 | ||
33 | The class pointer is x\bxm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxW\bWi\bid\bdg\bge\bet\btC\bCl\bla\bas\bss\bs. | |
34 | ||
35 | The class name is X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bx. | |
36 | ||
37 | N\bNe\bew\bw R\bRe\bes\bso\bou\bur\brc\bce\bes\bs | |
38 | The following table defines a set of widget resources used | |
39 | by the programmer to specify data. The programmer can also | |
40 | set the resource values for the inherited classes to set | |
41 | attributes for this widget. To reference a resource by | |
42 | name or by class in a .Xdefaults file, remove the X\bXm\bmN\bN or | |
43 | X\bXm\bmC\bC prefix and use the remaining letters. To specify one | |
44 | of the defined values for a resource in a .Xdefaults file, | |
45 | remove the X\bXm\bm prefix and use the remaining letters (in | |
46 | either lowercase or uppercase, but include any underscores | |
47 | between words). The codes in the access column indicate if | |
48 | the given resource can be set at creation time (C), set by | |
49 | using X\bXt\btS\bSe\bet\btV\bVa\bal\blu\bue\bes\bs (S), retrieved by using X\bXt\btG\bGe\bet\btV\bVa\bal\blu\bue\bes\bs (G), | |
50 | or is not applicable (N/A). | |
51 | ||
52 | X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bx R\bRe\bes\bso\bou\bur\brc\bce\be S\bSe\bet\bt | |
53 | ----------------------------------------------------------------- | |
54 | N\bNa\bam\bme\be D\bDe\bef\bfa\bau\bul\blt\bt A\bAc\bcc\bce\bes\bss\bs | |
55 | C\bCl\bla\bas\bss\bs T\bTy\byp\bpe\be | |
56 | ----------------------------------------------------------------- | |
57 | XmNactivateCallback NULL C | |
58 | XmCCallback XtCallbackList | |
59 | ----------------------------------------------------------------- | |
60 | ||
61 | ||
62 | ||
63 | ||
64 | Version 1.31 20 March 1995 1 | |
65 | ||
66 | ||
67 | ||
68 | ||
69 | ||
70 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
71 | ||
72 | ||
73 | XmNalignment XmALIGNMENT_CENTER CSG | |
74 | XmCAlignment unsigned char | |
75 | ----------------------------------------------------------------- | |
76 | XmNarrowSpacingOn False CSG | |
77 | XmNCArrowSpacingOn Boolean | |
78 | ----------------------------------------------------------------- | |
79 | XmNautomaticSelection False CSG | |
80 | XmCAutomaticSelection Boolean | |
81 | ----------------------------------------------------------------- | |
82 | XmNblinkRate 500 CSG | |
83 | XmCBlinkRate int | |
84 | ----------------------------------------------------------------- | |
85 | XmNcolumns dynamic CSG | |
86 | XmCColumns short | |
87 | ----------------------------------------------------------------- | |
88 | XmNcursorPosition 0 CSG | |
89 | XmCCursorPosition XmTextPosition | |
90 | ----------------------------------------------------------------- | |
91 | XmNcursorPositionVisible True CSG | |
92 | XmCCursorPositionVisible Boolean | |
93 | ----------------------------------------------------------------- | |
94 | XmNdefaultActionCallback NULL CSG | |
95 | XmCCallback XtCallbackList | |
96 | ----------------------------------------------------------------- | |
97 | XmNdropDownCallback NULL CSG | |
98 | XmCDropDownCallback XtCallbackList | |
99 | ----------------------------------------------------------------- | |
100 | XmNdropDownCursor center_ptr CSG | |
101 | XmCDropDownCursor Cursor | |
102 | ----------------------------------------------------------------- | |
103 | XmNdropDownOffset dynamic CSG | |
104 | XmCDropDownOffset Position | |
105 | ----------------------------------------------------------------- | |
106 | XmNeditable False CG | |
107 | XmCEditable Boolean | |
108 | ----------------------------------------------------------------- | |
109 | XmNfontList dynamic CSG | |
110 | XmCFontList XmFontList | |
111 | ----------------------------------------------------------------- | |
112 | XmNitemCount 0 CSG | |
113 | XmCItemCount int | |
114 | ----------------------------------------------------------------- | |
115 | XmNitems NULL CSG | |
116 | XmCItems XmStringTable | |
117 | ----------------------------------------------------------------- | |
118 | XmNlabelFontList dynamic CSG | |
119 | XmCLabelFontList XmFontList | |
120 | ----------------------------------------------------------------- | |
121 | XmNlabelInsensitivePixmap XmUNSPECIFIED_PIXMAP CSG | |
122 | XmCLabelInsensitivePixmap Pixmap | |
123 | ----------------------------------------------------------------- | |
124 | XmNlabelMarginBottom 0 CSG | |
125 | ||
126 | ||
127 | ||
128 | ||
129 | ||
130 | Version 1.31 20 March 1995 2 | |
131 | ||
132 | ||
133 | ||
134 | ||
135 | ||
136 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
137 | ||
138 | ||
139 | XmCLabelMarginBottom Dimension | |
140 | ----------------------------------------------------------------- | |
141 | XmNlabelMarginHeight 2 CSG | |
142 | XmCLabelMarginHeight Dimension | |
143 | ----------------------------------------------------------------- | |
144 | XmNlabelMarginLeft 0 CSG | |
145 | XmCLabelMarginLeft Dimension | |
146 | ----------------------------------------------------------------- | |
147 | XmNlabelMarginRight 0 CSG | |
148 | XmCLabelMarginRight Dimension | |
149 | ----------------------------------------------------------------- | |
150 | XmNlabelMarginTop 0 CSG | |
151 | XmCLabelMarginTop Dimension | |
152 | ----------------------------------------------------------------- | |
153 | XmNlabelMarginWidth 0 CSG | |
154 | XmCLabelMarginWidth Dimension | |
155 | ----------------------------------------------------------------- | |
156 | XmNlabelPixmap XmUNSPECIFIED_PIXMAP CSG | |
157 | XmCLabelPixmap Pixmap | |
158 | ----------------------------------------------------------------- | |
159 | XmNlabelString dynamic CSG | |
160 | XmCXmString XmString | |
161 | ----------------------------------------------------------------- | |
162 | XmNlabelType XmSTRING CSG | |
163 | XmCLabelType unsigned char | |
164 | ----------------------------------------------------------------- | |
165 | XmNlistMarginHeight 0 CSG | |
166 | XmCListMarginHeight Dimension | |
167 | ----------------------------------------------------------------- | |
168 | XmNlistMarginWidth 0 CSG | |
169 | XmCListMarginWidth Dimension | |
170 | ----------------------------------------------------------------- | |
171 | XmNlistSizePolicy XmVARIABLE CG | |
172 | XmCListSizePolicy unsigned char | |
173 | ----------------------------------------------------------------- | |
174 | XmNlistSpacing 0 CSG | |
175 | XmCListSpacing Dimension | |
176 | ----------------------------------------------------------------- | |
177 | XmNmarginHeight 5 CSG | |
178 | XmCMarginHeight Dimension | |
179 | ----------------------------------------------------------------- | |
180 | XmNmarginWidth 5 CSG | |
181 | XmCMarginWidth Dimension | |
182 | ----------------------------------------------------------------- | |
183 | XmNmaxLength largest integer CSG | |
184 | XmCMaxLength int | |
185 | ----------------------------------------------------------------- | |
186 | XmNmodifyVerifyCallback NULL CSG | |
187 | XmCCallback XtCallbackList | |
188 | ----------------------------------------------------------------- | |
189 | XmNmotionVerifyCallback NULL CSG | |
190 | XmCCallback XtCallbackList | |
191 | ----------------------------------------------------------------- | |
192 | ||
193 | ||
194 | ||
195 | ||
196 | Version 1.31 20 March 1995 3 | |
197 | ||
198 | ||
199 | ||
200 | ||
201 | ||
202 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
203 | ||
204 | ||
205 | XmNpersistentDropDown False CSG | |
206 | XmCPersistentDropDown Boolean | |
207 | ----------------------------------------------------------------- | |
208 | XmNscrollBarDisplayPolicy XmAS_NEEDED CSG | |
209 | XmCScrollBarDisplayPolicy unsigned char | |
210 | ----------------------------------------------------------------- | |
211 | XmNselectionCallback NULL CSG | |
212 | XmCCallback XtCallbackList | |
213 | ----------------------------------------------------------------- | |
214 | XmNselectionPolicy XmBROWSE_SELECT CG | |
215 | XmCSelectionPolicy unsigned char | |
216 | ----------------------------------------------------------------- | |
217 | XmNselectThreshold 5 CSG | |
218 | XmCSelectThreshold int | |
219 | ----------------------------------------------------------------- | |
220 | XmNshowLabel False CG | |
221 | XmCShowLabel Boolean | |
222 | ----------------------------------------------------------------- | |
223 | XmNsorted False CSG | |
224 | XmCSorted Boolean | |
225 | ----------------------------------------------------------------- | |
226 | XmNsortingCallback NULL CSG | |
227 | XmCCallback XtCallbackList | |
228 | ----------------------------------------------------------------- | |
229 | XmNsquareArrow False CSG | |
230 | XmCSquareArrow Boolean | |
231 | ----------------------------------------------------------------- | |
232 | XmNstaticList False CSG | |
233 | XmCStaticList Boolean | |
234 | ----------------------------------------------------------------- | |
235 | XmNstringDirection dynamic CSG | |
236 | XmCStringDirection XmStringDirection | |
237 | ----------------------------------------------------------------- | |
238 | XmNtwmHandlingOn False CSG | |
239 | XmCTwmHandlingOn Boolean | |
240 | ----------------------------------------------------------------- | |
241 | XmNtopItemPostion 1 G | |
242 | XmCTopItemPostion int | |
243 | ----------------------------------------------------------------- | |
244 | XmNunselectionCallback NULL CSG | |
245 | XmCCallback XtCallbackList | |
246 | ----------------------------------------------------------------- | |
247 | XmNvalue "" CSG | |
248 | XmCValue String | |
249 | ----------------------------------------------------------------- | |
250 | XmNvalueChangedCallback NULL CSG | |
251 | XmCCallback XtCallbackList | |
252 | ----------------------------------------------------------------- | |
253 | XmNvisibleItemCount 8 CSG | |
254 | XmCVisibleItemCount Int | |
255 | ----------------------------------------------------------------- | |
256 | ||
257 | X\bXm\bmN\bNa\bac\bct\bti\biv\bva\bat\bte\beC\bCa\bal\bll\blb\bba\bac\bck\bk | |
258 | Specifies a list of callbacks to be called when the | |
259 | ||
260 | ||
261 | ||
262 | Version 1.31 20 March 1995 4 | |
263 | ||
264 | ||
265 | ||
266 | ||
267 | ||
268 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
269 | ||
270 | ||
271 | user presses either the key "Enter" or "Activate". | |
272 | The type of the structure passed to this callback | |
273 | is X\bXm\bmA\bAn\bny\byC\bCa\bal\bll\blb\bba\bac\bck\bkS\bSt\btr\bru\buc\bct\bt and the reason is | |
274 | X\bXm\bmC\bCR\bR_\b_A\bAC\bCT\bTI\bIV\bVA\bAT\bTE\bE. | |
275 | ||
276 | X\bXm\bmN\bNa\bal\bli\big\bgn\bnm\bme\ben\bnt\bt | |
277 | The alignment (left to right) for the label's text | |
278 | or pixmap. Possible values are X\bXm\bmA\bAL\bLI\bIG\bGN\bN-\b- | |
279 | M\bME\bEN\bNT\bT_\b_B\bBE\bEG\bGI\bIN\bNN\bNI\bIN\bNG\bG, X\bXm\bmA\bAL\bLI\bIG\bGN\bNM\bME\bEN\bNT\bT_\b_C\bCE\bEN\bNT\bTE\bER\bR, and X\bXm\bmA\bAL\bLI\bIG\bGN\bN-\b- | |
280 | M\bME\bEN\bNT\bT_\b_E\bEN\bND\bD. | |
281 | ||
282 | X\bXm\bmN\bNa\bau\but\bto\bom\bma\bat\bti\bic\bcS\bSe\bel\ble\bec\bct\bti\bio\bon\bn | |
283 | Indicates whether the X\bXm\bmN\bNs\bse\bel\ble\bec\bct\bti\bio\bon\bnC\bCa\bal\bll\blb\bba\bac\bck\bk is | |
284 | invoked each time the user moves into a new item if | |
285 | X\bXm\bmN\bNa\bau\but\bto\bom\bma\bat\bti\bic\bcS\bSe\bel\ble\bec\bct\bti\bio\bon\bn is T\bTr\bru\bue\be and the selection | |
286 | mode is X\bXm\bmB\bBR\bRO\bOW\bWS\bSE\bE_\b_S\bSE\bEL\bLE\bEC\bCT\bT. If set to F\bFa\bal\bls\bse\be the X\bXm\bmN\bNs\bs-\b- | |
287 | e\bel\ble\bec\bct\bti\bio\bon\bnC\bCa\bal\bll\blb\bba\bac\bck\bk is not invoked until the user | |
288 | releases the mouse button. | |
289 | ||
290 | X\bXm\bmN\bNa\bar\brr\bro\bow\bwS\bSp\bpa\bac\bci\bin\bng\bgO\bOn\bn | |
291 | Indicates whether a gap is displayed between the | |
292 | arrow button and the text input field if this | |
293 | resource is set to T\bTr\bru\bue\be and X\bXm\bmN\bNe\bed\bdi\bit\bta\bab\bbl\ble\be is also set | |
294 | to T\bTr\bru\bue\be. If this resource is set to F\bFa\bal\bls\bse\be the | |
295 | combo box widget will never display a gab between | |
296 | the arrow button and the text area, irrespective of | |
297 | the setting of X\bXm\bmN\bNe\bed\bdi\bit\bta\bab\bbl\ble\be. Note that setting | |
298 | X\bXm\bmN\bNa\bar\brr\bro\bow\bwS\bSp\bpa\bac\bci\bin\bng\bgO\bOn\bn to F\bFa\bal\bls\bse\be doesn not conform to | |
299 | common GUI styles. And it prevents the user from | |
300 | easily recognizing whether the combo box is | |
301 | editable or not. | |
302 | ||
303 | X\bXm\bmN\bNb\bbl\bli\bin\bnk\bkR\bRa\bat\bte\be | |
304 | The time in milliseconds that the cursor spends | |
305 | being visible or invisible. A value of 0 prevents | |
306 | the cursor from blinking. | |
307 | ||
308 | X\bXm\bmN\bNb\bbo\bor\brd\bde\ber\brW\bWi\bid\bdt\bth\bh | |
309 | That's no new resource but is already introduced in | |
310 | the core class. This class overrides the default | |
311 | value and sets it to zero. You can however override | |
312 | it again if you're dissatisfied with the new | |
313 | default setting. | |
314 | ||
315 | X\bXm\bmN\bNc\bco\bol\blu\bum\bmn\bns\bs | |
316 | Specifies the initial width of the input field mea- | |
317 | sured in character spaces. The default value | |
318 | depends on the value of the width of the combo box. | |
319 | ||
320 | X\bXm\bmN\bNc\bcu\bur\brs\bso\bor\brP\bPo\bos\bsi\bit\bti\bio\bon\bn | |
321 | Indicates the position in the text where the insert | |
322 | cursor is to be located. Its position is the offset | |
323 | of characters and it starts with offset 0 at the | |
324 | beginning of the text. | |
325 | ||
326 | ||
327 | ||
328 | Version 1.31 20 March 1995 5 | |
329 | ||
330 | ||
331 | ||
332 | ||
333 | ||
334 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
335 | ||
336 | ||
337 | X\bXm\bmN\bNc\bcu\bur\brs\bso\bor\brP\bPo\bos\bsi\bit\bti\bio\bon\bnV\bVi\bis\bsi\bib\bbl\ble\be | |
338 | Flags whether the insert cursor position is marked | |
339 | by a blinking cursor. | |
340 | ||
341 | X\bXm\bmN\bNd\bde\bef\bfa\bau\bul\blt\btA\bAc\bct\bti\bio\bon\bnC\bCa\bal\bll\blb\bba\bac\bck\bk | |
342 | Specifies a list of callbacks that is called every | |
343 | time an item is double clicked. The reason is | |
344 | X\bXm\bmC\bCR\bR_\b_D\bDE\bEF\bFA\bAU\bUL\bLT\bT_\b_A\bAC\bCT\bTI\bIO\bON\bN. Please remember that you | |
345 | can't use this callback if X\bXm\bmN\bNs\bst\bta\bat\bti\bic\bcL\bLi\bis\bst\bt is F\bFa\bal\bls\bse\be | |
346 | because the list is immediatly hidden after the | |
347 | user selected an item from the list. Thus the user | |
348 | can't double click on any item within the list. | |
349 | ||
350 | X\bXm\bmN\bNd\bdr\bro\bop\bpD\bDo\bow\bwn\bnC\bCa\bal\bll\blb\bba\bac\bck\bk | |
351 | This is a list of callbacks to be called when the | |
352 | list is about to be shown or hidden. The reasons | |
353 | are X\bXm\bmC\bCR\bR_\b_S\bSH\bHO\bOW\bW_\b_L\bLI\bIS\bST\bT or X\bXm\bmC\bCR\bR_\b_H\bHI\bID\bDE\bE_\b_L\bLI\bIS\bST\bT. | |
354 | ||
355 | X\bXm\bmN\bNd\bdr\bro\bop\bpD\bDo\bow\bwn\bnC\bCu\bur\brs\bso\bor\br | |
356 | Specifies the cursor to be used whenever the mouse | |
357 | cursor is within the drop down list. | |
358 | ||
359 | X\bXm\bmN\bNd\bdr\bro\bop\bpD\bDo\bow\bwn\bnO\bOf\bff\bfs\bse\bet\bt | |
360 | Specifies the distance between the left border of | |
361 | the list and the left border of the input field. | |
362 | The default value is set to the width of the arrow | |
363 | button. Only positive values are allowed for X\bXm\bmN\bN-\b- | |
364 | d\bdr\bro\bop\bpD\bDo\bow\bwn\bnO\bOf\bff\bfs\bse\bet\bt, negative ones will be ignored. | |
365 | ||
366 | X\bXm\bmN\bNe\bed\bdi\bit\bta\bab\bbl\ble\be | |
367 | Specifies the type of combo box. If set to True, | |
368 | the combo box contains an editable input field. | |
369 | Therefore, the user is free to select entries out | |
370 | of the list and to enter new text or modify it. In | |
371 | the other case, with XmNeditable set to False the | |
372 | user can solely browse in and select entries out of | |
373 | the list. | |
374 | ||
375 | X\bXm\bmN\bNf\bfo\bon\bnt\btL\bLi\bis\bst\bt | |
376 | Indicates the font list to be used for the input | |
377 | field and the list. If the value is NULL at ini- | |
378 | tialization, it is initialized by looking up the | |
379 | parent hierarchy of the widget for an ancestor that | |
380 | is a subclass of X\bXm\bmB\bBu\bul\bll\ble\bet\bti\bin\bnB\bBo\boa\bar\brd\bd, X\bXm\bmV\bVe\ben\bnd\bdo\bor\brS\bSh\bhe\bel\bll\bl or | |
381 | X\bXm\bmM\bMe\ben\bnu\buS\bSh\bhe\bel\bll\bl. If such an ancestor is found, it's | |
382 | font list will be taken by the combo box widget. | |
383 | ||
384 | X\bXm\bmN\bNi\bit\bte\bem\bmC\bCo\bou\bun\bnt\bt | |
385 | Specifies the total number of items in the list. | |
386 | ||
387 | X\bXm\bmN\bNi\bit\bte\bem\bms\bs | |
388 | Points to an array of compound strings representing | |
389 | the items to be displayed in the list. By means of | |
390 | this a program can find out what items the list | |
391 | ||
392 | ||
393 | ||
394 | Version 1.31 20 March 1995 6 | |
395 | ||
396 | ||
397 | ||
398 | ||
399 | ||
400 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
401 | ||
402 | ||
403 | contains. It is also possible to set the contents | |
404 | of the list box in one step by setting this | |
405 | resource to a new array of compound strings. Please | |
406 | remember: always set X\bXm\bmN\bNi\bit\bte\bem\bms\bs and X\bXm\bmN\bNi\bit\bte\bem\bmC\bCo\bou\bun\bnt\bt | |
407 | together in the same call to X\bXt\btS\bSe\bet\btV\bVa\bal\blu\bue\bes\bs or | |
408 | X\bXt\btV\bVa\baS\bSe\bet\btV\bVa\bal\blu\bue\bes\bs. If you ignore this rule the combo | |
409 | box will ignore you and your attempt to set these | |
410 | resources. | |
411 | ||
412 | X\bXm\bmN\bNl\bla\bab\bbe\bel\blI\bIn\bns\bse\ben\bns\bsi\bit\bti\biv\bve\beP\bPi\bix\bxm\bma\bap\bp | |
413 | Specifies a pixmap used as the button face if X\bXm\bmN\bN-\b- | |
414 | l\bla\bab\bbe\bel\blT\bTy\byp\bpe\be is set to X\bXm\bmP\bPI\bIX\bXM\bMA\bAP\bP and the combo box wid- | |
415 | get is insensitive. | |
416 | ||
417 | X\bXm\bmN\bNl\bla\bab\bbe\bel\blP\bPi\bix\bxm\bma\bap\bp | |
418 | Specifies a pixmap to be displayed to the left of | |
419 | the input field if X\bXm\bmN\bNl\bla\bab\bbe\bel\blT\bTy\byp\bpe\be is X\bXm\bmP\bPI\bIX\bXM\bMA\bAP\bP and | |
420 | X\bXm\bmN\bNs\bsh\bho\bow\bwL\bLa\bab\bbe\bel\bl is True (of course). | |
421 | ||
422 | X\bXm\bmN\bNl\bla\bab\bbe\bel\blS\bSt\btr\bri\bin\bng\bg | |
423 | Specifies the the compound string to be displayed | |
424 | if X\bXm\bmN\bNl\bla\bab\bbe\bel\blT\bTy\byp\bpe\be is set to X\bXm\bmS\bST\bTR\bRI\bIN\bNG\bG and X\bXm\bmN\bNs\bsh\bho\bow\bwL\bLa\bab\bbe\bel\bl | |
425 | is True. | |
426 | ||
427 | X\bXm\bmN\bNl\bla\bab\bbe\bel\blT\bTy\byp\bpe\be | |
428 | The type of label (either string or pixmap). Possi- | |
429 | ble values are X\bXm\bmP\bPI\bIX\bXM\bMA\bAP\bP and X\bXm\bmS\bST\bTR\bRI\bIN\bNG\bG. | |
430 | ||
431 | X\bXm\bmN\bNl\bla\bab\bbe\bel\blM\bMa\bar\brg\bgi\bin\bnT\bTo\bop\bp,\b, X\bXm\bmN\bNl\bla\bab\bbe\bel\blM\bMa\bar\brg\bgi\bin\bnB\bBo\bot\btt\bto\bom\bm | |
432 | X\bXm\bmN\bNl\bla\bab\bbe\bel\blM\bMa\bar\brg\bgi\bin\bnL\bLe\bef\bft\bt,\b, X\bXm\bmN\bNl\bla\bab\bbe\bel\blM\bMa\bar\brg\bgi\bin\bnR\bRi\big\bgh\bht\bt | |
433 | The amount of space between one side of the label | |
434 | and the nearest margin. | |
435 | ||
436 | X\bXm\bmN\bNl\bla\bab\bbe\bel\blM\bMa\bar\brg\bgi\bin\bnH\bHe\bei\big\bgh\bht\bt,\b, X\bXm\bmN\bNl\bla\bab\bbe\bel\blM\bMa\bar\brg\bgi\bin\bnW\bWi\bid\bdt\bth\bh | |
437 | The spacing between one side of the label and the | |
438 | nearest edge of a shadow. | |
439 | ||
440 | X\bXm\bmN\bNl\bli\bis\bst\btM\bMa\bar\brg\bgi\bin\bnH\bHe\bei\big\bgh\bht\bt,\b, X\bXm\bmN\bNl\bli\bis\bst\btM\bMa\bar\brg\bgi\bin\bnW\bWi\bid\bdt\bth\bh | |
441 | The height or width of the margin between the bor- | |
442 | der of the list and the items in the list. | |
443 | ||
444 | X\bXm\bmN\bNl\bli\bis\bst\btS\bSi\biz\bze\beP\bPo\bol\bli\bic\bcy\by | |
445 | Controls the reaction of the list when an item | |
446 | grows horizontally beyond the current width of the | |
447 | list and X\bXm\bmN\bNs\bst\bta\bat\bti\bic\bcL\bLi\bis\bst\bt is set to T\bTr\bru\bue\be. If set to | |
448 | X\bXm\bmC\bCO\bON\bNS\bST\bTA\bAN\bNT\bT, the list does not grow, and a horizon- | |
449 | tal scroll bar is shown. If this resource is set to | |
450 | X\bXm\bmV\bVA\bAR\bRI\bIA\bAB\bBL\bLE\bE, the list instead trys to grow such that | |
451 | it match the size of the longest item, thus no hor- | |
452 | izontal scroll bar will appear. When X\bXm\bmN\bNl\bli\bis\bst\bt-\b- | |
453 | S\bSi\biz\bze\beP\bPo\bol\bli\bic\bcy\by is the list will again try to grow but | |
454 | in case the width of the longest item in the list | |
455 | is wider than the viewing area of the list a hori- | |
456 | zontal scroll bar appears. | |
457 | ||
458 | ||
459 | ||
460 | Version 1.31 20 March 1995 7 | |
461 | ||
462 | ||
463 | ||
464 | ||
465 | ||
466 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
467 | ||
468 | ||
469 | X\bXm\bmN\bNl\bli\bis\bst\btS\bSp\bpa\bac\bci\bin\bng\bg | |
470 | The spacing between items in the list. | |
471 | ||
472 | X\bXm\bmN\bNm\bma\bar\brg\bgi\bin\bnH\bHe\bei\big\bgh\bht\bt | |
473 | Specifies the distance between the top and the bot- | |
474 | tom of the widget window and the text displayed in | |
475 | the input field. | |
476 | ||
477 | X\bXm\bmN\bNm\bma\bar\brg\bgi\bin\bnW\bWi\bid\bdt\bth\bh | |
478 | Like XmNmarginHeight this resource specifies the | |
479 | distance between the left and the right border of | |
480 | the widget window and the text. | |
481 | ||
482 | X\bXm\bmN\bNm\bma\bax\bxL\bLe\ben\bng\bgt\bth\bh | |
483 | Specifies the maximum length of the text string | |
484 | that can be entered from the keyboard into the | |
485 | input field of the combo box. Strings that are put | |
486 | into the input field using X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxS\bSe\bet\btS\bSt\btr\bri\bin\bng\bg | |
487 | ignore this resource. | |
488 | ||
489 | X\bXm\bmN\bNm\bmo\bod\bdi\bif\bfy\byV\bVe\ber\bri\bif\bfy\byC\bCa\bal\bll\blb\bba\bac\bck\bk | |
490 | Contains a list of callbacks called before text is | |
491 | deleted from or inserted into the text area of the | |
492 | combo box widget. The callbacks are called only if | |
493 | X\bXm\bmN\bNe\bed\bdi\bit\bta\bab\bbl\ble\be is set to T\bTr\bru\bue\be. The reason is | |
494 | X\bXm\bmC\bCR\bR_\b_M\bMO\bOD\bDI\bIF\bFY\bYI\bIN\bNG\bG_\b_T\bTE\bEX\bXT\bT_\b_V\bVA\bAL\bLU\bUE\bE and the type of the | |
495 | structure passed to this callback is X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bx-\b- | |
496 | T\bTe\bex\bxt\btV\bVe\ber\bri\bif\bfy\byC\bCa\bal\bll\blb\bba\bac\bck\bkS\bSt\btr\bru\buc\bct\bt. | |
497 | ||
498 | X\bXm\bmN\bNm\bmo\bot\bti\bio\bon\bnV\bVe\ber\bri\bif\bfy\byC\bCa\bal\bll\blb\bba\bac\bck\bk | |
499 | Specifies the list of callbacks that is called | |
500 | before the insert cursor gets moved to another | |
501 | position. The reason is X\bXm\bmC\bCR\bR_\b_M\bMO\bOV\bVI\bIN\bNG\bG_\b_I\bIN\bNS\bSE\bER\bRT\bT_\b_C\bCU\bUR\bRS\bSO\bOR\bR | |
502 | and the type of the structure whose address is | |
503 | passed to the callback is X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxT\bTe\bex\bxt\btV\bVe\ber\bri\bif\bfy\byC\bCa\bal\bll\bl-\b- | |
504 | b\bba\bac\bck\bk-\b-S\bSt\btr\bru\buc\bct\bt. | |
505 | ||
506 | X\bXm\bmN\bNs\bsc\bcr\bro\bol\bll\blB\bBa\bar\brD\bDi\bis\bsp\bpl\bla\bay\byP\bPo\bol\bli\bic\bcy\by | |
507 | Controls the display of the vertical scroll bar in | |
508 | the list when X\bXm\bmN\bNs\bst\bta\bat\bti\bic\bcL\bLi\bis\bst\bt is set to T\bTr\bru\bue\be.\b.When | |
509 | X\bXm\bmN\bNs\bsc\bcr\bro\bol\bll\blB\bBa\bar\brD\bDi\bis\bsp\bpl\bla\bay\byP\bPo\bol\bli\bic\bcy\by is set to X\bXm\bmA\bAS\bS_\b_N\bNE\bEE\bED\bDE\bED\bD, | |
510 | the vertical scroll bar is displayed only when the | |
511 | list contains more items than can be currently dis- | |
512 | played. If set to X\bXm\bmS\bST\bTA\bAT\bTI\bIC\bC the vertical scroll bar | |
513 | is always displayed. | |
514 | ||
515 | X\bXm\bmN\bNp\bpe\ber\brs\bsi\bis\bst\bte\ben\bnt\btD\bDr\bro\bop\bpD\bDo\bow\bwn\bn | |
516 | Welcome to the sad section in the life of X11 | |
517 | applications. This resource and the inherent prob- | |
518 | lems are due to the focus policy of the window man- | |
519 | ager you're using. See the further details in the | |
520 | later sections. | |
521 | ||
522 | ||
523 | ||
524 | ||
525 | ||
526 | Version 1.31 20 March 1995 8 | |
527 | ||
528 | ||
529 | ||
530 | ||
531 | ||
532 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
533 | ||
534 | ||
535 | X\bXm\bmN\bNs\bse\bel\ble\bec\bct\bti\bio\bon\bnC\bCa\bal\bll\blb\bba\bac\bck\bk | |
536 | Specifies a list of callbacks that is called when | |
537 | an item is selected. The reason is | |
538 | X\bXm\bmC\bCR\bR_\b_S\bSI\bIN\bNG\bGL\bLE\bE_\b_S\bSE\bEL\bLE\bEC\bCT\bT. The callbacks are NOT called | |
539 | when the user browses through the items in the | |
540 | list. | |
541 | ||
542 | X\bXm\bmN\bNs\bse\bel\ble\bec\bct\bti\bio\bon\bnP\bPo\bol\bli\bic\bcy\by | |
543 | This resource controls whether the user can dese- | |
544 | lect the currently selected item within a combo | |
545 | box. The default value is X\bXm\bmB\bBR\bRO\bOW\bWS\bSE\bE_\b_S\bSE\bEL\bLE\bEC\bCT\bT, so | |
546 | always one item gets selected if the combo box is | |
547 | editable. In the case of X\bXm\bmS\bSI\bIN\bNG\bGL\bLE\bE_\b_S\bSE\bEL\bLE\bEC\bCT\bT the user | |
548 | may deselect the current item either by clicking on | |
549 | it in the drop down list or pressing the key | |
550 | "Delete". Other values for X\bXm\bmN\bNs\bse\bel\ble\bec\bct\bti\bio\bon\bnP\bPo\bol\bli\bic\bcy\by are | |
551 | currently not allowed. (Multiple selections will be | |
552 | probably availabe with the next release.) | |
553 | ||
554 | X\bXm\bmN\bNs\bse\bel\ble\bec\bct\btT\bTh\bhr\bre\bes\bsh\bho\bol\bld\bd | |
555 | Specifies the amount of pixels the mouse must move | |
556 | until the selection of text is recognized in click | |
557 | and drag mode. | |
558 | ||
559 | X\bXm\bmN\bNs\bsh\bho\bow\bwL\bLa\bab\bbe\bel\bl | |
560 | Specifies, whether a label containing text or a | |
561 | pixmap should be displayed on the left side of the | |
562 | combo box. This resource can only be specified dur- | |
563 | ing the creation of the combo box, afterwards it | |
564 | will have no effect. | |
565 | ||
566 | X\bXm\bmN\bNs\bso\bor\brt\bte\bed\bd | |
567 | Specifies whether the items in the list are sorted | |
568 | or not In an unsorted list, the items are shown in | |
569 | the order in which they're put into the list. When | |
570 | adding an item to a sorted list, this item will be | |
571 | put at the right place (alphabetically sorted). | |
572 | ||
573 | X\bXm\bmN\bNs\bso\bor\brt\bti\bin\bng\bgC\bCa\bal\bll\blb\bba\bac\bck\bk | |
574 | Contains a list of callbacks that is called when- | |
575 | ever a new item is added to the combo box widget | |
576 | and X\bXm\bmN\bNs\bso\bor\brt\bte\bed\bd is T\bTr\bru\bue\be. The reason is X\bXm\bmC\bCR\bR_\b_S\bSO\bOR\bRT\bTI\bIN\bNG\bG | |
577 | and the type of the structure whose address is | |
578 | passed to the callback is X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxS\bSo\bor\brt\bti\bin\bng\bgC\bCa\bal\bll\bl-\b- | |
579 | b\bba\bac\bck\bk-\b-S\bSt\btr\bru\buc\bct\bt. For detailed information see the fol- | |
580 | lowing sections. | |
581 | ||
582 | X\bXm\bmN\bNs\bsq\bqu\bua\bar\bre\beA\bAr\brr\bro\bow\bw | |
583 | Controls the width of the arrow button in respect | |
584 | to its height. If this resource is T\bTr\bru\bue\be the arrow | |
585 | button is always layed out square. Otherwise the | |
586 | arrow button's width will be approximatly 4/5th of | |
587 | its height. | |
588 | ||
589 | ||
590 | ||
591 | ||
592 | Version 1.31 20 March 1995 9 | |
593 | ||
594 | ||
595 | ||
596 | ||
597 | ||
598 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
599 | ||
600 | ||
601 | X\bXm\bmN\bNs\bst\bta\bat\bti\bic\bcL\bLi\bis\bst\bt | |
602 | Controls whether the list is always statically dis- | |
603 | played right below the text input area of the combo | |
604 | box if set to T\bTr\bru\bue\be. If you use a combo box with | |
605 | X\bXm\bmN\bNs\bst\bta\bat\bti\bic\bcL\bLi\bis\bst\bt set to T\bTr\bru\bue\be and X\bXm\bmN\bNe\bed\bdi\bit\bta\bab\bbl\ble\be set to | |
606 | F\bFa\bal\bls\bse\be you should consider using a simple list wid- | |
607 | get instead. | |
608 | ||
609 | X\bXm\bmN\bNs\bst\btr\bri\bin\bng\bgD\bDi\bir\bre\bec\bct\bti\bio\bon\bn | |
610 | Specifies the initial direction to draw the string | |
611 | (from the left to the right or in the opposite | |
612 | direction). The whole story seems to be incompre- | |
613 | hensible... therefore this resource is provided for | |
614 | completeness only. | |
615 | ||
616 | X\bXm\bmN\bNt\btw\bwm\bmH\bHa\ban\bnd\bdl\bli\bin\bng\bgO\bOn\bn | |
617 | If you have trouble with the list then this | |
618 | resource may help you. Set it to True, if the list | |
619 | gets hidden at the moment the mouse cursor enters | |
620 | the list. | |
621 | ||
622 | X\bXm\bmN\bNt\bto\bop\bpI\bIt\bte\bem\bmP\bPo\bos\bsi\bit\bti\bio\bon\bn | |
623 | This resource is intended as an informal hint. It | |
624 | specifies the index of the item which is displayed | |
625 | at the visible top of the list. | |
626 | ||
627 | X\bXm\bmN\bNv\bva\bal\blu\bue\be | |
628 | Contains the text of the input field. This also | |
629 | concerns combo boxes which are not editable ( | |
630 | X\bXm\bmN\bNe\bed\bdi\bit\bta\bab\bbl\ble\be set to False). | |
631 | ||
632 | X\bXm\bmN\bNu\bun\bns\bse\bel\ble\bec\bct\bti\bio\bon\bnC\bCa\bal\bll\blb\bba\bac\bck\bk | |
633 | Specifies a list of callbacks that is called when- | |
634 | ever the currently selected item is deselected and | |
635 | no other item gets selected. This callback is acti- | |
636 | vated only when X\bXm\bmN\bNs\bse\bel\ble\bec\bct\bti\bio\bon\bnP\bPo\bol\bli\bic\bcy\by is X\bXm\bmS\bSI\bIN\bN-\b- | |
637 | G\bGL\bLE\bE_\b_S\bSE\bEL\bLE\bEC\bCT\bT. The reason is X\bXm\bmC\bCR\bR_\b_U\bUN\bNS\bSE\bEL\bLE\bEC\bCT\bT. The type | |
638 | of the structure whose address is passed to this | |
639 | callback is X\bXm\bmA\bAn\bny\byC\bCa\bal\bll\blb\bba\bac\bck\bkS\bSt\btr\bru\buc\bct\bt. | |
640 | ||
641 | X\bXm\bmN\bNv\bva\bal\blu\bue\be | |
642 | Contains the text of the input field. This also | |
643 | concerns combo boxes which are not editable ( | |
644 | X\bXm\bmN\bNe\bed\bdi\bit\bta\bab\bbl\ble\be set to F\bFa\bal\bls\bse\be). | |
645 | ||
646 | X\bXm\bmN\bNv\bva\bal\blu\bue\beC\bCh\bha\ban\bng\bge\bed\bdC\bCa\bal\bll\blb\bba\bac\bck\bk | |
647 | Specifies a list of callbacks to be called after | |
648 | text is deleted from or inserted into the text area | |
649 | of the combo box widget. The reason is | |
650 | X\bXm\bmC\bCR\bR_\b_V\bVA\bAL\bLU\bUE\bE_\b_C\bCH\bHA\bAN\bNG\bGE\bED\bD. The type of the structure | |
651 | whose address is passed to this callback is X\bXm\bmA\bAn\bny\by-\b- | |
652 | C\bCa\bal\bll\blb\bba\bac\bck\bkS\bSt\btr\bru\buc\bct\bt. | |
653 | ||
654 | ||
655 | ||
656 | ||
657 | ||
658 | Version 1.31 20 March 1995 10 | |
659 | ||
660 | ||
661 | ||
662 | ||
663 | ||
664 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
665 | ||
666 | ||
667 | X\bXm\bmN\bNv\bvi\bis\bsi\bib\bbl\ble\beI\bIt\bte\bem\bmC\bCo\bou\bun\bnt\bt | |
668 | Specifies the number of items that can fit in the | |
669 | visible space of the list. The combo box uses this | |
670 | value to determine the height of its list. | |
671 | ||
672 | I\bIn\bnh\bhe\ber\bri\bit\bte\bed\bd R\bRe\bes\bso\bou\bur\brc\bce\bes\bs | |
673 | XmComboBox inherits behaviour and resources from the fol- | |
674 | lowing superclasses. For a complete description of each | |
675 | resource, refer to the man page for that superclass. | |
676 | ||
677 | C\bCa\bal\bll\blb\bba\bac\bck\bk I\bIn\bnf\bfo\bor\brm\bma\bat\bti\bio\bon\bn | |
678 | A pointer to the following structure is passed to the | |
679 | X\bXm\bmN\bNd\bdr\bro\bop\bpD\bDo\bow\bwn\bnC\bCa\bal\bll\blb\bba\bac\bck\bk callback: | |
680 | ||
681 | t\bty\byp\bpe\bed\bde\bef\bf s\bst\btr\bru\buc\bct\bt {\b{ | |
682 | i\bin\bnt\bt _\br_\be_\ba_\bs_\bo_\bn;\b; | |
683 | X\bXE\bEv\bve\ben\bnt\bt *\b*_\be_\bv_\be_\bn_\bt;\b; | |
684 | }\b} X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxD\bDr\bro\bop\bpD\bDo\bow\bwn\bnC\bCa\bal\bll\blb\bba\bac\bck\bkS\bSt\btr\bru\buc\bct\bt;\b; | |
685 | ||
686 | _\br_\be_\ba_\bs_\bo_\bn Within this structure, _\br_\be_\ba_\bs_\bo_\bn indicates the | |
687 | reason why the callback was activated. This | |
688 | can be X\bXm\bmC\bCR\bR_\b_S\bSH\bHO\bOW\bW_\b_L\bLI\bIS\bST\bT as well as | |
689 | X\bXm\bmC\bCR\bR_\b_H\bHI\bID\bDE\bE_\b_L\bLI\bIS\bST\bT. A callback is called with | |
690 | the reason X\bXm\bmC\bCR\bR_\b_S\bSH\bHO\bOW\bW_\b_L\bLI\bIS\bST\bT just before the | |
691 | list is dropped down, whereas the callback | |
692 | is called with X\bXm\bmC\bCR\bR_\b_H\bHI\bID\bDE\bE_\b_L\bLI\bIS\bST\bT after the | |
693 | list is hidden. | |
694 | ||
695 | ||
696 | _\be_\bv_\be_\bn_\bt Points to the X\bXE\bEv\bve\ben\bnt\bt, which triggered the | |
697 | callback. May be N\bNU\bUL\bLL\bL if the callback is | |
698 | triggered by a call to X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxS\bSh\bho\bow\bwL\bLi\bis\bst\bt | |
699 | or X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxH\bHi\bid\bde\beL\bLi\bis\bst\bt. | |
700 | ||
701 | A pointer to the following structure is passed to the | |
702 | X\bXm\bmN\bNa\bac\bct\bti\biv\bva\bat\bte\beC\bCa\bal\bll\blb\bba\bac\bck\bk callback: | |
703 | ||
704 | t\bty\byp\bpe\bed\bde\bef\bf s\bst\btr\bru\buc\bct\bt {\b{ | |
705 | i\bin\bnt\bt _\br_\be_\ba_\bs_\bo_\bn;\b; | |
706 | X\bXE\bEv\bve\ben\bnt\bt *\b*_\be_\bv_\be_\bn_\bt;\b; | |
707 | }\b} X\bXm\bmA\bAn\bny\byC\bCa\bal\bll\blb\bba\bac\bck\bkS\bSt\btr\bru\buc\bct\bt;\b; | |
708 | ||
709 | _\br_\be_\ba_\bs_\bo_\bn Indicates why the callback was invoked. | |
710 | This is X\bXm\bmC\bCR\bR_\b_A\bAC\bCT\bTI\bIV\bVA\bAT\bTE\bE for X\bXm\bmN\bNa\bac\bct\bti\biv\bva\bat\bte\beC\bCa\bal\bll\bl-\b- | |
711 | b\bba\bac\bck\bk. | |
712 | ||
713 | _\be_\bv_\be_\bn_\bt Points to the X\bXE\bEv\bve\ben\bnt\bt, which triggered the | |
714 | callback. | |
715 | ||
716 | A pointer to the following structure is passed to the | |
717 | X\bXm\bmN\bNs\bse\bel\ble\bec\bct\bti\bio\bon\bnC\bCa\bal\bll\blb\bba\bac\bck\bk and X\bXm\bmN\bNd\bde\bef\bfa\bau\bul\blt\btA\bAc\bct\bti\bio\bon\bnC\bCa\bal\bll\blb\bba\bac\bck\bk: | |
718 | ||
719 | t\bty\byp\bpe\bed\bde\bef\bf s\bst\btr\bru\buc\bct\bt {\b{ | |
720 | i\bin\bnt\bt _\br_\be_\ba_\bs_\bo_\bn;\b; | |
721 | ||
722 | ||
723 | ||
724 | Version 1.31 20 March 1995 11 | |
725 | ||
726 | ||
727 | ||
728 | ||
729 | ||
730 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
731 | ||
732 | ||
733 | X\bXE\bEv\bve\ben\bnt\bt *\b*_\be_\bv_\be_\bn_\bt;\b; | |
734 | X\bXm\bmS\bSt\btr\bri\bin\bng\bg _\bv_\ba_\bl_\bu_\be;\b; | |
735 | i\bin\bnt\bt _\bi_\bn_\bd_\be_\bx;\b; | |
736 | }\b} X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxS\bSe\bel\ble\bec\bct\bti\bio\bon\bnC\bCa\bal\bll\blb\bba\bac\bck\bkS\bSt\btr\bru\buc\bct\bt,\b, X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxD\bDe\bef\bfa\bau\bul\blt\btA\bAc\bc-\b- | |
737 | t\bti\bio\bon\bnC\bCa\bal\bll\blb\bba\bac\bck\bkS\bSt\btr\bru\buc\bct\bt;\b; | |
738 | ||
739 | _\br_\be_\ba_\bs_\bo_\bn Within this structure, _\br_\be_\ba_\bs_\bo_\bn indicates the | |
740 | reason why the callback was activated. At | |
741 | this time, the reason can be either | |
742 | X\bXm\bmC\bCR\bR_\b_S\bSI\bIN\bNG\bGL\bLE\bE_\b_S\bSE\bEL\bLE\bEC\bCT\bT or X\bXm\bmC\bCR\bR_\b_B\bBR\bRO\bOW\bWS\bSE\bE_\b_S\bSE\bEL\bLE\bEC\bCT\bT | |
743 | depending on the setting of X\bXm\bmN\bNs\bse\bel\ble\bec\bct\bti\bio\bon\bn-\b- | |
744 | P\bPo\bol\bli\bic\bcy\by. It indicates that the user | |
745 | selected a (potentially new) item in the | |
746 | list. Whether this callback is activated | |
747 | every time the user moves into a new item | |
748 | of the list or only when the user releases | |
749 | the mouse button is controlled through the | |
750 | setting of X\bXm\bmN\bNa\bau\but\bto\bom\bma\bat\bti\bic\bcS\bSe\bel\ble\bec\bct\bti\bio\bon\bn. | |
751 | ||
752 | _\be_\bv_\be_\bn_\bt Points to the X\bXE\bEv\bve\ben\bnt\bt, which triggered the | |
753 | callback. | |
754 | ||
755 | _\bv_\ba_\bl_\bu_\be Points to a X\bXm\bmS\bSt\btr\bri\bin\bng\bg, which contains the | |
756 | text of the current selected item. This | |
757 | X\bXm\bmS\bSt\btr\bri\bin\bng\bg must never be freed or changed by | |
758 | the called program code! | |
759 | ||
760 | _\bi_\bn_\bd_\be_\bx Index (starting from 1) of the currently | |
761 | selected item in the list. | |
762 | ||
763 | A pointer to the following structure is passed to the | |
764 | X\bXm\bmN\bNu\bun\bns\bse\bel\ble\bec\bct\bti\bio\bon\bnC\bCa\bal\bll\blb\bba\bac\bck\bk callback: | |
765 | ||
766 | t\bty\byp\bpe\bed\bde\bef\bf s\bst\btr\bru\buc\bct\bt {\b{ | |
767 | i\bin\bnt\bt _\br_\be_\ba_\bs_\bo_\bn;\b; | |
768 | X\bXE\bEv\bve\ben\bnt\bt *\b*_\be_\bv_\be_\bn_\bt;\b; | |
769 | }\b} X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxU\bUn\bns\bse\bel\ble\bec\bct\bti\bio\bon\bnC\bCa\bal\bll\blb\bba\bac\bck\bkS\bSt\btr\bru\buc\bct\bt;\b; | |
770 | ||
771 | _\br_\be_\ba_\bs_\bo_\bn Indicates why the callback was invoked. | |
772 | This is X\bXm\bmC\bCR\bR_\b_U\bUN\bNS\bSE\bEL\bLE\bEC\bCT\bT. | |
773 | ||
774 | _\be_\bv_\be_\bn_\bt Points to the X\bXE\bEv\bve\ben\bnt\bt, which triggered the | |
775 | callback. | |
776 | ||
777 | A pointer to the following structure is passed to the | |
778 | X\bXm\bmN\bNm\bmo\bod\bdi\bif\bfy\byV\bVe\ber\bri\bif\bfy\byC\bCa\bal\bll\blb\bba\bac\bck\bk and X\bXm\bmN\bNm\bmo\bot\bti\bio\bon\bnV\bVe\ber\bri\bif\bfy\byC\bCa\bal\bll\blb\bba\bac\bck\bk call- | |
779 | backs: | |
780 | ||
781 | t\bty\byp\bpe\bed\bde\bef\bf s\bst\btr\bru\buc\bct\bt {\b{ | |
782 | i\bin\bnt\bt _\br_\be_\ba_\bs_\bo_\bn;\b; | |
783 | X\bXE\bEv\bve\ben\bnt\bt *\b*_\be_\bv_\be_\bn_\bt;\b; | |
784 | B\bBo\boo\bol\ble\bea\ban\bn _\bd_\bo_\bi_\bt;\b; | |
785 | P\bPo\bos\bsi\bit\bti\bio\bon\bn _\bc_\bu_\br_\br_\bI_\bn_\bs_\be_\br_\bt_\b, _\bn_\be_\bw_\bI_\bn_\bs_\be_\br_\bt;\b; | |
786 | P\bPo\bos\bsi\bit\bti\bio\bon\bn _\bs_\bt_\ba_\br_\bt_\bP_\bo_\bs_\b, _\be_\bn_\bd_\bP_\bo_\bs;\b; | |
787 | ||
788 | ||
789 | ||
790 | Version 1.31 20 March 1995 12 | |
791 | ||
792 | ||
793 | ||
794 | ||
795 | ||
796 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
797 | ||
798 | ||
799 | X\bXm\bmT\bTe\bex\bxt\btB\bBl\blo\boc\bck\bk _\bt_\be_\bx_\bt;\b; | |
800 | }\b} X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxT\bTe\bex\bxt\btV\bVe\ber\bri\bif\bfy\byC\bCa\bal\bll\blb\bba\bac\bck\bkS\bSt\btr\bru\buc\bct\bt,\b, *\b*X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxT\bTe\bex\bxt\btV\bVe\ber\bri\bi-\b- | |
801 | f\bfy\byP\bPt\btr\br;\b; | |
802 | ||
803 | _\br_\be_\ba_\bs_\bo_\bn Indicates the reason why the callback was | |
804 | activated. This can be either | |
805 | X\bXm\bmC\bCR\bR_\b_M\bMO\bOD\bDI\bIF\bFY\bYI\bIN\bNG\bG_\b_T\bTE\bEX\bXT\bT_\b_V\bVA\bAL\bLU\bUE\bE or | |
806 | X\bXm\bmC\bCR\bR_\b_M\bMO\bOV\bVI\bIN\bNG\bG_\b_I\bIN\bNS\bSE\bER\bRT\bT_\b_C\bCU\bUR\bRS\bSO\bOR\bR. | |
807 | ||
808 | _\be_\bv_\be_\bn_\bt Points to the X\bXE\bEv\bve\ben\bnt\bt, which triggered the | |
809 | callback. | |
810 | ||
811 | _\bd_\bo_\bi_\bt Indicates whether the offending action | |
812 | should be performed. Setting this field of | |
813 | the callback structure to F\bFa\bal\bls\bse\be denies the | |
814 | action. | |
815 | ||
816 | _\bc_\bu_\br_\br_\bI_\bn_\bs_\be_\br_\bt Specifies the current position of the | |
817 | insert cursor. | |
818 | ||
819 | Indicates the position at which the user | |
820 | attempts to position the cursor. | |
821 | ||
822 | _\bs_\bt_\ba_\br_\bt_\bP_\bo_\bs Indicates the starting position of the text | |
823 | to modify. If the reason is | |
824 | X\bXm\bmC\bCR\bR_\b_M\bMO\bOV\bVI\bIN\bNG\bG_\b_I\bIN\bNS\bSE\bER\bRT\bT_\b_C\bCU\bUR\bRS\bSO\bOR\bR this value is the | |
825 | same as c\bcu\bur\brr\brI\bIn\bns\bse\ber\brt\bt. | |
826 | ||
827 | _\be_\bn_\bd_\bP_\bo_\bs Specifies the ending position of the text | |
828 | to modify. If no text is replaced or | |
829 | deleted, then the value will be the same as | |
830 | s\bst\bta\bar\brt\btP\bPo\bos\bs. If the reason is | |
831 | X\bXm\bmC\bCR\bR_\b_M\bMO\bOD\bDI\bIF\bFY\bYI\bIN\bNG\bG_\b_T\bTE\bEX\bXT\bT_\b_V\bVA\bAL\bLU\bUE\bE this value is the | |
832 | same as _\bc_\bu_\br_\br_\bI_\bn_\bs_\be_\br_\bt. | |
833 | ||
834 | _\bt_\be_\bx_\bt Holds the address of a structure of type | |
835 | X\bXm\bmT\bTe\bex\bxt\btB\bBl\blo\boc\bck\bkR\bRe\bec\bc which holds the textual | |
836 | information to be inserted. | |
837 | ||
838 | The following table describes the reasons why the individ- | |
839 | ual verification callback structure fields are valid. | |
840 | ||
841 | R\bRe\bea\bas\bso\bon\bn V\bVa\bal\bli\bid\bd F\bFi\bie\bel\bld\bds\bs | |
842 | ----------------------------------------------------- | |
843 | X\bXm\bmC\bCR\bR_\b_M\bMO\bOD\bDI\bIF\bFY\bYI\bIN\bNG\bG_\b_T\bTE\bEX\bXT\bT_\b_V\bVA\bAL\bLU\bUE\bE _\br_\be_\ba_\bs_\bo_\bn, _\be_\bv_\be_\bn_\bt, _\bd_\bo_\bi_\bt, | |
844 | _\bs_\bt_\ba_\br_\bt_\bP_\bo_\bs, _\be_\bn_\bd_\bP_\bo_\bs, _\bt_\be_\bx_\bt | |
845 | ||
846 | X\bXm\bmC\bCR\bR_\b_M\bMO\bOV\bVI\bIN\bNG\bG_\b_I\bIN\bNS\bSE\bER\bRT\bT_\b_C\bCU\bUR\bRS\bSO\bOR\bR _\br_\be_\ba_\bs_\bo_\bn, _\be_\bv_\be_\bn_\bt, _\bd_\bo_\bi_\bt, | |
847 | _\bc_\bu_\br_\br_\bI_\bn_\bs_\be_\br_\bt, _\bn_\be_\bw_\bI_\bn_\bs_\be_\br_\bt, | |
848 | ||
849 | A pointer to the following structure is passed to the X\bXm\bmN\bN-\b- | |
850 | s\bso\bor\brt\bti\bin\bng\bgC\bCa\bal\bll\blb\bba\bac\bck\bk callback: t\bty\byp\bpe\bed\bde\bef\bf s\bst\btr\bru\buc\bct\bt {\b{ | |
851 | i\bin\bnt\bt _\br_\be_\ba_\bs_\bo_\bn;\b; | |
852 | X\bXE\bEv\bve\ben\bnt\bt *\b*_\be_\bv_\be_\bn_\bt;\b; | |
853 | ||
854 | ||
855 | ||
856 | Version 1.31 20 March 1995 13 | |
857 | ||
858 | ||
859 | ||
860 | ||
861 | ||
862 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
863 | ||
864 | ||
865 | i\bin\bnt\bt _\bo_\bp_\be_\br_\ba_\bt_\bi_\bo_\bn;\b; | |
866 | v\bvo\boi\bid\bd *\b*_\bi_\bt_\be_\bm_\b__\bi_\bn_\bt_\be_\br_\bn_\ba_\bl;\b; | |
867 | X\bXm\bmS\bSt\btr\bri\bin\bng\bg _\bi_\bt_\be_\bm;\b; | |
868 | i\bin\bnt\bt _\br_\be_\bs_\bu_\bl_\bt;\b; | |
869 | }\b} X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxS\bSo\bor\brt\bti\bin\bng\bgC\bCa\bal\bll\blb\bba\bac\bck\bkS\bSt\btr\bru\buc\bct\bt,\b, *\b*X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxS\bSo\bor\brt\bti\bin\bng\bgP\bPt\btr\br;\b; | |
870 | ||
871 | _\br_\be_\ba_\bs_\bo_\bn Indicates the reason why the callback was | |
872 | activated. This is X\bXm\bmC\bCR\bR_\b_S\bSO\bOR\bRT\bTI\bIN\bNG\bG. | |
873 | ||
874 | _\be_\bv_\be_\bn_\bt Contains always N\bNU\bUL\bLL\bL and is just there for | |
875 | compatibility reasons. | |
876 | ||
877 | _\bo_\bp_\be_\br_\ba_\bt_\bi_\bo_\bn Indicates the operation to carry out and | |
878 | can be either X\bXm\bmO\bOP\bP_\b_I\bIN\bNI\bIT\bT,X\bXm\bmO\bOP\bP_\b_D\bDO\bON\bNE\bE or | |
879 | X\bXm\bmO\bOP\bP_\b_C\bCO\bOM\bMP\bPA\bAR\bRE\bE. | |
880 | ||
881 | _\bi_\bt_\be_\bm_\b__\bi_\bn_\bt_\be_\br_\bn_\ba_\bl Must be set during the X\bXm\bmO\bOP\bP_\b_I\bIN\bNI\bIT\bT operation | |
882 | to a suitable representation of the new | |
883 | item which is to be added to the list. In | |
884 | all subsequent calls to this callback with | |
885 | X\bXm\bmO\bOP\bP_\b_C\bCO\bOM\bMP\bPA\bAR\bRE\bEorX\bXm\bmO\bOP\bP_\b_D\bDO\bON\bNE\bE this field will | |
886 | contain whatever you've put into it during | |
887 | X\bXm\bmO\bOP\bP_\b_I\bIN\bNI\bIT\bT. For detailed information refer | |
888 | to the documentation "_\bT_\bh_\be _\bC_\bo_\bm_\bb_\bo_\bB_\bo_\bx _\bW_\bi_\bd_\bg_\be_\bt". | |
889 | ||
890 | _\bi_\bt_\be_\bm During X\bXm\bmO\bOP\bP_\b_I\bIN\bNI\bIT\bT this field points to the | |
891 | item to be added to the list. When sorting | |
892 | the list ( X\bXm\bmO\bOP\bP_\b_C\bCO\bOM\bMP\bPA\bAR\bRE\bE) the field contains | |
893 | the address of an item in the list which | |
894 | should be compared against the new item (as | |
895 | remembered in _\bi_\bt_\be_\bm_\b__\bi_\bn_\bt_\be_\br_\bn_\ba_\bl). | |
896 | ||
897 | _\br_\be_\bs_\bu_\bl_\bt When comparing an item (out of the list) in | |
898 | _\bi_\bt_\be_\bm with the new item (as remembered in | |
899 | _\bi_\bt_\be_\bm_\b__\bi_\bn_\bt_\be_\br_\bn_\ba_\bl) the result has to be stored | |
900 | into this structure's field. | |
901 | ||
902 | The following table describes which individual callback | |
903 | structure fields are valid during which operations. | |
904 | ||
905 | R\bRe\bea\bas\bso\bon\bn V\bVa\bal\bli\bid\bd F\bFi\bie\bel\bld\bds\bs | |
906 | --------------------------------------------- | |
907 | X\bXm\bmO\bOP\bP_\b_I\bIN\bNI\bIT\bT _\br_\be_\ba_\bs_\bo_\bn, _\be_\bv_\be_\bn_\bt, _\bo_\bp_\be_\br_\ba_\bt_\bi_\bo_\bn, | |
908 | _\bi_\bt_\be_\bm, _\bi_\bt_\be_\bm_\b__\bi_\bn_\bt_\be_\br_\bn_\ba_\bl | |
909 | X\bXm\bmO\bOP\bP_\b_D\bDO\bON\bNE\bE _\br_\be_\ba_\bs_\bo_\bn, _\be_\bv_\be_\bn_\bt, _\bo_\bp_\be_\br_\ba_\bt_\bi_\bo_\bn, | |
910 | _\bi_\bt_\be_\bm_\b__\bi_\bn_\bt_\be_\br_\bn_\ba_\bl | |
911 | X\bXm\bmO\bOP\bP_\b_C\bCO\bOM\bMP\bPA\bAR\bRE\bE _\br_\be_\ba_\bs_\bo_\bn, _\be_\bv_\be_\bn_\bt, _\bo_\bp_\be_\br_\ba_\bt_\bi_\bo_\bn, | |
912 | _\bi_\bt_\be_\bm, _\bi_\bt_\be_\bm_\b__\bi_\bn_\bt_\be_\br_\bn_\ba_\bl, _\br_\be_\bs_\bu_\bl_\bt | |
913 | ||
914 | For more information about controlling the sorting order | |
915 | see the acompanying documentation "_\bT_\bh_\be _\bC_\bo_\bm_\bb_\bo_\bB_\bo_\bx _\bW_\bi_\bd_\bg_\be_\bt". | |
916 | ||
917 | C\bCo\bon\bnv\bve\ben\bni\bie\ben\bnc\bce\be r\bro\bou\but\bti\bin\bne\bes\bs | |
918 | ComboBox has a number of convenience routines to control | |
919 | ||
920 | ||
921 | ||
922 | Version 1.31 20 March 1995 14 | |
923 | ||
924 | ||
925 | ||
926 | ||
927 | ||
928 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
929 | ||
930 | ||
931 | the behavior and contents of its children. | |
932 | ||
933 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxA\bAd\bdd\bdI\bIt\bte\bem\bm(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, X\bXm\bmS\bSt\btr\bri\bin\bng\bg i\bit\bte\bem\bm,\b, i\bin\bnt\bt p\bpo\bos\bs)\b) | |
934 | Add a new item to the list's contents. If X\bXm\bmN\bNs\bso\bor\brt\bte\bed\bd | |
935 | is set to True, the new item is inserted alphabeti- | |
936 | cally. If the list is unsorted, the same assump- | |
937 | tions can be applied as with X\bXm\bmL\bLi\bis\bst\btA\bAd\bdd\bdI\bIt\bte\bem\bm. | |
938 | ||
939 | ||
940 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxA\bAd\bdd\bdI\bIt\bte\bem\bms\bs(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, X\bXm\bmS\bSt\btr\bri\bin\bng\bg *\b*i\bit\bte\bem\bms\bs,\b, | |
941 | i\bin\bnt\bt i\bit\bte\bem\bm_\b_c\bco\bou\bun\bnt\bt,\b, i\bin\bnt\bt p\bpo\bos\bs)\b) | |
942 | Similar to X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxA\bAd\bdd\bdI\bIt\bte\bem\bm. Also see X\bXm\bmL\bLi\bis\bst\btA\bAd\bd-\b- | |
943 | d\bdI\bIt\bte\bem\bms\bs. | |
944 | ||
945 | ||
946 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxA\bAd\bdd\bdI\bIt\bte\bem\bmU\bUn\bns\bse\bel\ble\bec\bct\bte\bed\bd(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, X\bXm\bmS\bSt\btr\bri\bin\bng\bg | |
947 | i\bit\bte\bem\bm,\b, i\bin\bnt\bt p\bpo\bos\bs)\b) | |
948 | See X\bXm\bmL\bLi\bis\bst\btA\bAd\bdd\bdI\bIt\bte\bem\bmU\bUn\bns\bse\bel\ble\bec\bct\bte\bed\bd. | |
949 | ||
950 | ||
951 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxC\bCl\ble\bea\bar\brI\bIt\bte\bem\bmS\bSe\bel\ble\bec\bct\bti\bio\bon\bn(\b(W\bWi\bid\bdg\bge\bet\bt w\bw)\b) | |
952 | Deselects all currently selected items when | |
953 | X\bXm\bmN\bNs\bse\bel\ble\bec\bct\bti\bio\bon\bnP\bPo\bol\bli\bic\bcy\by is X\bXm\bmS\bSI\bIN\bNG\bGL\bLE\bE_\b_S\bSE\bEL\bLE\bEC\bCT\bT. | |
954 | ||
955 | ||
956 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxD\bDe\bel\ble\bet\bte\beI\bIt\bte\bem\bm(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, X\bXm\bmS\bSt\btr\bri\bin\bng\bg i\bit\bte\bem\bm)\b) | |
957 | See X\bXm\bmL\bLi\bis\bst\btD\bDe\bel\ble\bet\bte\beI\bIt\bte\bem\bm. | |
958 | ||
959 | ||
960 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxD\bDe\bel\ble\bet\bte\beI\bIt\bte\bem\bms\bs(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, X\bXm\bmS\bSt\btr\bri\bin\bng\bg | |
961 | *\b*i\bit\bte\bem\bms\bs,\b, i\bin\bnt\bt i\bit\bte\bem\bm_\b_c\bco\bou\bun\bnt\bt)\b) | |
962 | See X\bXm\bmL\bLi\bis\bst\btD\bDe\bel\ble\bet\bte\beI\bIt\bte\bem\bms\bs. | |
963 | ||
964 | ||
965 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxD\bDe\bel\ble\bet\bte\beP\bPo\bos\bs(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, i\bin\bnt\bt p\bpo\bos\bs)\b) | |
966 | See X\bXm\bmL\bLi\bis\bst\btD\bDe\bel\ble\bet\bte\beP\bPo\bos\bs. | |
967 | ||
968 | ||
969 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxD\bDe\bel\ble\bet\bte\beI\bIt\bte\bem\bms\bsP\bPo\bos\bs(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, i\bin\bnt\bt i\bit\bte\bem\bm_\b_c\bco\bou\bun\bnt\bt,\b, | |
970 | i\bin\bnt\bt p\bpo\bos\bs)\b) | |
971 | See X\bXm\bmL\bLi\bis\bst\btD\bDe\bel\ble\bet\bte\beI\bIt\bte\bem\bms\bsP\bPo\bos\bs. | |
972 | ||
973 | ||
974 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxD\bDe\bel\ble\bet\bte\beA\bAl\bll\blI\bIt\bte\bem\bms\bs(\b(W\bWi\bid\bdg\bge\bet\bt w\bw)\b) | |
975 | See X\bXm\bmL\bLi\bis\bst\btD\bDe\bel\ble\bet\bte\beA\bAl\bll\blI\bIt\bte\bem\bms\bs. | |
976 | ||
977 | ||
978 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxR\bRe\bep\bpl\bla\bac\bce\beI\bIt\bte\bem\bms\bs(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, X\bXm\bmS\bSt\btr\bri\bin\bng\bg | |
979 | *\b*o\bol\bld\bd_\b_i\bit\bte\bem\bms\bs,\b, i\bin\bnt\bt i\bit\bte\bem\bm_\b_c\bco\bou\bun\bnt\bt,\b, X\bXm\bmS\bSt\btr\bri\bin\bng\bg *\b*n\bne\bew\bw_\b_i\bit\bte\bem\bms\bs)\b) | |
980 | See X\bXm\bmL\bLi\bis\bst\btR\bRe\bep\bpl\bla\bac\bce\beI\bIt\bte\bem\bms\bs. | |
981 | ||
982 | ||
983 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxR\bRe\bep\bpl\bla\bac\bce\beI\bIt\bte\bem\bms\bsP\bPo\bos\bs(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, X\bXm\bmS\bSt\btr\bri\bin\bng\bg | |
984 | *\b*n\bne\bew\bw_\b_i\bit\bte\bem\bms\bs,\b, i\bin\bnt\bt i\bit\bte\bem\bm_\b_c\bco\bou\bun\bnt\bt,\b, i\bin\bnt\bt p\bpo\bos\bsi\bit\bti\bio\bon\bn)\b) | |
985 | ||
986 | ||
987 | ||
988 | Version 1.31 20 March 1995 15 | |
989 | ||
990 | ||
991 | ||
992 | ||
993 | ||
994 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
995 | ||
996 | ||
997 | See X\bXm\bmL\bLi\bis\bst\btR\bRe\bep\bpl\bla\bac\bce\beI\bIt\bte\bem\bms\bsP\bPo\bos\bs. | |
998 | ||
999 | ||
1000 | B\bBo\boo\bol\ble\bea\ban\bn X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxI\bIt\bte\bem\bmE\bEx\bxi\bis\bst\bts\bs(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, X\bXm\bmS\bSt\btr\bri\bin\bng\bg i\bit\bte\bem\bm)\b) | |
1001 | See X\bXm\bmL\bLi\bis\bst\btI\bIt\bte\bem\bmE\bEx\bxi\bis\bst\bts\bs. | |
1002 | ||
1003 | ||
1004 | i\bin\bnt\bt X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxI\bIt\bte\bem\bmP\bPo\bos\bs(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, X\bXm\bmS\bSt\btr\bri\bin\bng\bg i\bit\bte\bem\bm)\b) | |
1005 | See X\bXm\bmL\bLi\bis\bst\btI\bIt\bte\bem\bmP\bPo\bos\bs. | |
1006 | ||
1007 | ||
1008 | B\bBo\boo\bol\ble\bea\ban\bn X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxG\bGe\bet\btM\bMa\bat\btc\bch\bhP\bPo\bos\bs(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, X\bXm\bmS\bSt\btr\bri\bin\bng\bg | |
1009 | i\bit\bte\bem\bm,\b, i\bin\bnt\bt *\b**\b*p\bpo\bos\bs_\b_l\bli\bis\bst\bt,\b, i\bin\bnt\bt *\b*p\bpo\bos\bs_\b_c\bco\bou\bun\bnt\bt)\b) | |
1010 | See X\bXm\bmL\bLi\bis\bst\btG\bGe\bet\btM\bMa\bat\btc\bch\bhP\bPo\bos\bs. | |
1011 | ||
1012 | ||
1013 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxS\bSe\bel\ble\bec\bct\btP\bPo\bos\bs(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, i\bin\bnt\bt p\bpo\bos\bs,\b, B\bBo\boo\bol\ble\bea\ban\bn | |
1014 | n\bno\bot\bti\bif\bfy\by)\b) | |
1015 | See X\bXm\bmL\bLi\bis\bst\btS\bSe\bel\ble\bec\bct\btP\bPo\bos\bs. | |
1016 | ||
1017 | ||
1018 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxS\bSe\bel\ble\bec\bct\btI\bIt\bte\bem\bm(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, X\bXm\bmS\bSt\btr\bri\bin\bng\bg i\bit\bte\bem\bm,\b, | |
1019 | B\bBo\boo\bol\ble\bea\ban\bn n\bno\bot\bti\bif\bfy\by)\b) | |
1020 | See X\bXm\bmL\bLi\bis\bst\btS\bSe\bel\ble\bec\bct\btI\bIt\bte\bem\bm. | |
1021 | ||
1022 | ||
1023 | i\bin\bnt\bt X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxG\bGe\bet\btS\bSe\bel\ble\bec\bct\bte\bed\bdP\bPo\bos\bs(\b(W\bWi\bid\bdg\bge\bet\bt w\bw)\b) | |
1024 | This function differs from X\bXm\bmL\bLi\bis\bst\btG\bGe\bet\btS\bSe\bel\ble\bec\bct\bte\bed\bdP\bPo\bos\bs. | |
1025 | The list in a combo box can contain only one | |
1026 | selected item. Therefore this function returns the | |
1027 | index of the selected item in the list or zero, if | |
1028 | none is currently selected. | |
1029 | ||
1030 | ||
1031 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxC\bCl\ble\bea\bar\brS\bSe\bel\ble\bec\bct\bti\bio\bon\bn(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, T\bTi\bim\bme\be t\bti\bim\bme\be)\b) | |
1032 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdC\bCl\ble\bea\bar\brS\bSe\bel\ble\bec\bct\bti\bio\bon\bn. | |
1033 | ||
1034 | ||
1035 | B\bBo\boo\bol\ble\bea\ban\bn X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxC\bCo\bop\bpy\by(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, T\bTi\bim\bme\be t\bti\bim\bme\be)\b) | |
1036 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdC\bCo\bop\bpy\by. | |
1037 | ||
1038 | ||
1039 | B\bBo\boo\bol\ble\bea\ban\bn X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxC\bCu\but\bt(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, T\bTi\bim\bme\be t\bti\bim\bme\be)\b) | |
1040 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdC\bCu\but\bt. | |
1041 | ||
1042 | ||
1043 | X\bXm\bmT\bTe\bex\bxt\btP\bPo\bos\bsi\bit\bti\bio\bon\bn X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxG\bGe\bet\btI\bIn\bns\bse\ber\brt\bti\bio\bon\bnP\bPo\bos\bsi\bit\bti\bio\bon\bn(\b(W\bWi\bid\bdg\bge\bet\bt w\bw)\b) | |
1044 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdG\bGe\bet\btI\bIn\bns\bse\ber\brt\bti\bio\bon\bnP\bPo\bos\bsi\bit\bti\bio\bon\bn. | |
1045 | ||
1046 | ||
1047 | X\bXm\bmT\bTe\bex\bxt\btP\bPo\bos\bsi\bit\bti\bio\bon\bn X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxG\bGe\bet\btL\bLa\bas\bst\btP\bPo\bos\bsi\bit\bti\bio\bon\bn(\b(W\bWi\bid\bdg\bge\bet\bt w\bw)\b) | |
1048 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdG\bGe\bet\btL\bLa\bas\bst\btP\bPo\bos\bsi\bit\bti\bio\bon\bn. | |
1049 | ||
1050 | ||
1051 | ||
1052 | ||
1053 | ||
1054 | Version 1.31 20 March 1995 16 | |
1055 | ||
1056 | ||
1057 | ||
1058 | ||
1059 | ||
1060 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
1061 | ||
1062 | ||
1063 | i\bin\bnt\bt X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxG\bGe\bet\btM\bMa\bax\bxL\bLe\ben\bng\bgt\bth\bh(\b(W\bWi\bid\bdg\bge\bet\bt w\bw)\b) | |
1064 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdG\bGe\bet\btM\bMa\bax\bxL\bLe\ben\bng\bgt\bth\bh. | |
1065 | ||
1066 | ||
1067 | c\bch\bha\bar\br *\b*X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxG\bGe\bet\btS\bSe\bel\ble\bec\bct\bti\bio\bon\bn(\b(W\bWi\bid\bdg\bge\bet\bt w\bw)\b) | |
1068 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdG\bGe\bet\btS\bSe\bel\ble\bec\bct\bti\bio\bon\bn. | |
1069 | ||
1070 | ||
1071 | B\bBo\boo\bol\ble\bea\ban\bn X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxG\bGe\bet\btS\bSe\bel\ble\bec\bct\bti\bio\bon\bnP\bPo\bos\bsi\bit\bti\bio\bon\bn(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, | |
1072 | X\bXm\bmT\bTe\bex\bxt\btP\bPo\bos\bsi\bit\bti\bio\bon\bn *\b*l\ble\bef\bft\bt,\b, X\bXm\bmT\bTe\bex\bxt\btP\bPo\bos\bsi\bit\bti\bio\bon\bn *\b*r\bri\big\bgh\bht\bt)\b) | |
1073 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdG\bGe\bet\btS\bSe\bel\ble\bec\bct\bti\bio\bon\bnP\bPo\bos\bsi\bit\bti\bio\bon\bn. | |
1074 | ||
1075 | ||
1076 | c\bch\bha\bar\br *\b*X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxG\bGe\bet\btS\bSt\btr\bri\bin\bng\bg(\b(W\bWi\bid\bdg\bge\bet\bt w\bw)\b) | |
1077 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdG\bGe\bet\btS\bSt\btr\bri\bin\bng\bg. | |
1078 | ||
1079 | ||
1080 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxI\bIn\bns\bse\ber\brt\bt(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, X\bXm\bmT\bTe\bex\bxt\btP\bPo\bos\bsi\bit\bti\bio\bon\bn | |
1081 | p\bpo\bos\bsi\bit\bti\bio\bon\bn,\b, c\bch\bha\bar\br *\b*v\bva\bal\blu\bue\be)\b) | |
1082 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdI\bIn\bns\bse\ber\brt\bt. | |
1083 | ||
1084 | ||
1085 | B\bBo\boo\bol\ble\bea\ban\bn X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxP\bPa\bas\bst\bte\be(\b(W\bWi\bid\bdg\bge\bet\bt w\bw)\b) | |
1086 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdP\bPa\bas\bst\bte\be. | |
1087 | ||
1088 | ||
1089 | B\bBo\boo\bol\ble\bea\ban\bn X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxR\bRe\bem\bmo\bov\bve\be(\b(W\bWi\bid\bdg\bge\bet\bt w\bw)\b) | |
1090 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdR\bRe\bem\bmo\bov\bve\be. | |
1091 | ||
1092 | ||
1093 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxR\bRe\bep\bpl\bla\bac\bce\be(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, X\bXm\bmT\bTe\bex\bxt\btP\bPo\bos\bsi\bit\bti\bio\bon\bn | |
1094 | f\bfr\bro\bom\bm_\b_p\bpo\bos\bs,\b, X\bXm\bmT\bTe\bex\bxt\btP\bPo\bos\bsi\bit\bti\bio\bon\bn t\bto\bo_\b_p\bpo\bos\bs,\b, c\bch\bha\bar\br *\b*v\bva\bal\blu\bue\be)\b) | |
1095 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdR\bRe\bep\bpl\bla\bac\bce\be. | |
1096 | ||
1097 | ||
1098 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxS\bSe\bet\btA\bAd\bdd\bdM\bMo\bod\bde\be(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, B\bBo\boo\bol\ble\bea\ban\bn s\bst\bta\bat\bte\be)\b) | |
1099 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdS\bSe\bet\btA\bAd\bdd\bdM\bMo\bod\bde\be. | |
1100 | ||
1101 | ||
1102 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxS\bSe\bet\btH\bHi\big\bgh\bhl\bli\big\bgh\bht\bt(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, X\bXm\bmT\bTe\bex\bxt\btP\bPo\bos\bsi\bit\bti\bio\bon\bn | |
1103 | l\ble\bef\bft\bt,\b, X\bXm\bmT\bTe\bex\bxt\btP\bPo\bos\bsi\bit\bti\bio\bon\bn r\bri\big\bgh\bht\bt,\b, X\bXm\bmH\bHi\big\bgh\bhl\bli\big\bgh\bht\btM\bMo\bod\bde\be m\bmo\bod\bde\be)\b) | |
1104 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdS\bSe\bet\btH\bHi\big\bgh\bhl\bli\big\bgh\bht\bt. | |
1105 | ||
1106 | ||
1107 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxS\bSe\bet\btI\bIn\bns\bse\ber\brt\bti\bio\bon\bnP\bPo\bos\bsi\bit\bti\bio\bon\bn(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, | |
1108 | X\bXm\bmT\bTe\bex\bxt\btP\bPo\bos\bsi\bit\bti\bio\bon\bn p\bpo\bos\bsi\bit\bti\bio\bon\bn)\b) | |
1109 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdS\bSe\bet\btI\bIn\bns\bse\ber\brt\bti\bio\bon\bnP\bPo\bos\bsi\bit\bti\bio\bon\bn. | |
1110 | ||
1111 | ||
1112 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxS\bSe\bet\btM\bMa\bax\bxL\bLe\ben\bng\bgt\bth\bh(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, i\bin\bnt\bt m\bma\bax\bx_\b_l\ble\ben\bng\bgt\bth\bh)\b) | |
1113 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdS\bSe\bet\btM\bMa\bax\bxL\bLe\ben\bng\bgt\bth\bh. | |
1114 | ||
1115 | ||
1116 | ||
1117 | ||
1118 | ||
1119 | ||
1120 | Version 1.31 20 March 1995 17 | |
1121 | ||
1122 | ||
1123 | ||
1124 | ||
1125 | ||
1126 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
1127 | ||
1128 | ||
1129 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxS\bSe\bet\btS\bSe\bel\ble\bec\bct\bti\bio\bon\bn(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, X\bXm\bmT\bTe\bex\bxt\btP\bPo\bos\bsi\bit\bti\bio\bon\bn | |
1130 | f\bfi\bir\brs\bst\bt,\b, X\bXm\bmT\bTe\bex\bxt\btP\bPo\bos\bsi\bit\bti\bio\bon\bn l\bla\bas\bst\bt,\b, T\bTi\bim\bme\be t\bti\bim\bme\be)\b) | |
1131 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdS\bSe\bet\btS\bSe\bel\ble\bec\bct\bti\bio\bon\bn. | |
1132 | ||
1133 | ||
1134 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxS\bSe\bet\btS\bSt\btr\bri\bin\bng\bg(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, c\bch\bha\bar\br *\b*v\bva\bal\blu\bue\be)\b) | |
1135 | At least Motif 1.1 contains a very anoying bug. If | |
1136 | you try to set the contents of an XmTextField to an | |
1137 | empty string (""), you'll get garbage, when asking | |
1138 | the XmTextField for its contents afterwards. This | |
1139 | interface function provides a work around. Also see | |
1140 | X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdS\bSe\bet\btS\bSt\btr\bri\bin\bng\bg. | |
1141 | ||
1142 | ||
1143 | v\bvo\boi\bid\bd X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxS\bSh\bho\bow\bwP\bPo\bos\bsi\bit\bti\bio\bon\bn(\b(W\bWi\bid\bdg\bge\bet\bt w\bw,\b, X\bXm\bmT\bTe\bex\bxt\btP\bPo\bos\bsi\bit\bti\bio\bon\bn p\bpo\bos\bsi\bi-\b- | |
1144 | t\bti\bio\bon\bn)\b) | |
1145 | See X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bdS\bSh\bho\bow\bwP\bPo\bos\bsi\bit\bti\bio\bon\bn. | |
1146 | ||
1147 | ||
1148 | T\bTh\bhe\be D\bDi\bis\bsl\bli\bik\bke\bed\bd K\bKe\bey\byb\bbo\boa\bar\brd\bd F\bFo\boc\bcu\bus\bs | |
1149 | Now I'll annotate a somewhat tricky subject. If the | |
1150 | resource X\bXm\bmN\bNp\bpe\ber\brs\bsi\bis\bst\bte\ben\bnt\btD\bDr\bro\bop\bpD\bDo\bow\bwn\bn defaults to its initial | |
1151 | value of F\bFa\bal\bls\bse\be, one can observe the following effect (this | |
1152 | may be annoying). | |
1153 | ||
1154 | When the user drops down the list and then moves the mouse | |
1155 | cursor out of the window where the combo box resides in, | |
1156 | the list will be hidden. This is because the widget lost | |
1157 | the keyboard focus. Some users are irritated because they | |
1158 | didn't expect that behavior, because they just moved the | |
1159 | mouse to get it out of the way. If your window manager's | |
1160 | focus policy is "pointer focus", i.e. if you move the | |
1161 | pointer into another window, that window will automati- | |
1162 | cally get the keyboard focus. On the other hand, if your | |
1163 | window manager's focus policy is "explicit", you have to | |
1164 | move the pointer into another window and click a mouse | |
1165 | button to give that window the keyboard focus. This is | |
1166 | often referred to as the "click-to-type" method. In | |
1167 | "explicit" mode, you will never see the list's annoying | |
1168 | behavior. | |
1169 | ||
1170 | To bypass this behavior on some window managers a really | |
1171 | dirty hack was used. The user can activate that hack, if | |
1172 | he sets X\bXm\bmN\bNp\bpe\ber\brs\bsi\bis\bst\bte\ben\bnt\btD\bDr\bro\bop\bpD\bDo\bow\bwn\bn to T\bTr\bru\bue\be in the application's | |
1173 | resources. Sorry, on some window managers this will not | |
1174 | fix the annoying behavior. | |
1175 | ||
1176 | Try it if you like - but don't complain at me if it | |
1177 | doesn't work as expected. But at least it worked on the | |
1178 | author's machine: a cute little SGI Indigo running 4dwm as | |
1179 | the window manager. | |
1180 | ||
1181 | On some other window managers like twm you will face | |
1182 | another problem: the list gets hidden as soon as the mouse | |
1183 | ||
1184 | ||
1185 | ||
1186 | Version 1.31 20 March 1995 18 | |
1187 | ||
1188 | ||
1189 | ||
1190 | ||
1191 | ||
1192 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
1193 | ||
1194 | ||
1195 | cursor enters the list. Try to set X\bXm\bmN\bNt\btw\bwm\bmH\bHa\ban\bnd\bdl\bli\bin\bng\bgO\bOn\bn to | |
1196 | T\bTr\bru\bue\be. This resource will also work with other window man- | |
1197 | agers. | |
1198 | ||
1199 | ||
1200 | C\bCr\bre\bea\bat\bti\bin\bng\bg a\ba C\bCo\bom\bmb\bbo\boB\bBo\box\bx | |
1201 | Using the combo box in your own programs is easy. Just | |
1202 | create the widget with one of the innumerable X toolkit | |
1203 | functions (like X\bXt\btC\bCr\bre\bea\bat\bte\beM\bMa\ban\bna\bag\bge\bed\bdW\bWi\bid\bdg\bge\bet\bt or X\bXt\btV\bVa\baC\bCr\bre\bea\bat\bte\beM\bMa\ban\bn-\b- | |
1204 | a\bag\bge\bed\bdW\bWi\bid\bdg\bge\bet\bt). | |
1205 | ||
1206 | ||
1207 | Specify as the widget class xmComboBoxWidgetClass - that's | |
1208 | all. There is also a so-called creation convenience func- | |
1209 | tion called X\bXm\bmC\bCr\bre\bea\bat\bte\beC\bCo\bom\bmb\bbo\boB\bBo\box\bx, but it isn't really needed. | |
1210 | ||
1211 | W\bWi\bid\bdg\bge\bet\bt X\bXm\bmC\bCr\bre\bea\bat\bte\beC\bCo\bom\bmb\bbo\boB\bBo\box\bx(\b(_\bp_\ba_\br_\be_\bn_\bt_\b, _\bn_\ba_\bm_\be_\b, _\ba_\br_\bg_\bl_\bi_\bs_\bt_\b, _\ba_\br_\bg_\bc_\bo_\bu_\bn_\bt)\b) | |
1212 | W\bWi\bid\bdg\bge\bet\bt _\bp_\ba_\br_\be_\bn_\bt; | |
1213 | S\bSt\btr\bri\bin\bng\bg _\bn_\ba_\bm_\be; | |
1214 | A\bAr\brg\bgL\bLi\bis\bst\bt _\ba_\br_\bg_\bl_\bi_\bs_\bt; | |
1215 | C\bCa\bar\brd\bdi\bin\bna\bal\bl _\ba_\br_\bg_\bc_\bo_\bu_\bn_\bt; | |
1216 | ||
1217 | Somewhere in your program you'll need something like the | |
1218 | following code fragment: | |
1219 | ||
1220 | ||
1221 | Widget ComboBox; | |
1222 | ||
1223 | ComboBox = XtVaCreateManagedWidget("combobox", | |
1224 | xmComboBoxWidgetClass, Parent, | |
1225 | XmNeditable, True or False, | |
1226 | other Resources... | |
1227 | NULL); | |
1228 | ||
1229 | ||
1230 | Setting the resource X\bXm\bmN\bNe\bed\bdi\bit\bta\bab\bbl\ble\be is not absolutely neces- | |
1231 | sary, but it's better to do so. | |
1232 | ||
1233 | After creation, items can be added to the combo box's list | |
1234 | by means of interface functions like X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxA\bAd\bd-\b- | |
1235 | d\bdI\bIt\bte\bem\bm(\b(.\b..\b..\b.)\b). Which item the user selected can be deter- | |
1236 | mined by calling X\bXm\bmC\bCo\bom\bmb\bbo\boB\bBo\box\bxG\bGe\bet\btS\bSt\btr\bri\bin\bng\bg(\b(.\b..\b..\b.)\b). | |
1237 | ||
1238 | ||
1239 | If you want to preselect an item (that is setting a | |
1240 | default item to the input field of the combo box) you can | |
1241 | use several convenience functions. On a combo box with a | |
1242 | non editable input field there are two ways to select an | |
1243 | item: | |
1244 | ||
1245 | ||
1246 | XmComboBoxSelectPos(ComboBox, item #, False); | |
1247 | ||
1248 | or: | |
1249 | ||
1250 | ||
1251 | ||
1252 | Version 1.31 20 March 1995 19 | |
1253 | ||
1254 | ||
1255 | ||
1256 | ||
1257 | ||
1258 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
1259 | ||
1260 | ||
1261 | XmComboBoxSelectItem(ComboBox, itemString, False); | |
1262 | ||
1263 | The third parameter in these two function calls indicates | |
1264 | whether the X\bXm\bmN\bNs\bse\bel\ble\bec\bct\bti\bio\bon\bnC\bCa\bal\bll\blb\bba\bac\bck\bk should be called. The | |
1265 | only difference between these functions is the first one | |
1266 | is expecting an item number whereas the second one expects | |
1267 | a XmString. The list is then searched for this string and | |
1268 | if it is found the input field will be updated. | |
1269 | ||
1270 | On a combo box with X\bXm\bmN\bNe\bed\bdi\bit\bta\bab\bbl\ble\be set to T\bTr\bru\bue\be use another | |
1271 | function: | |
1272 | ||
1273 | XmComboBoxSetString(ComboBox, string); | |
1274 | ||
1275 | This sets the contents of the text input field to string. | |
1276 | ||
1277 | ||
1278 | ||
1279 | B\bBU\bUG\bGS\bS | |
1280 | Not more than currently available in Motif 1.2.3 or Motif | |
1281 | 1.2.4, but less than in the upcomming Motif 2.0. Report | |
1282 | bugs to albrecht@igpm.rwth-aachen.de. Include a thoroughly | |
1283 | description, and say which version of the ComboBox widget | |
1284 | you are using. | |
1285 | ||
1286 | ||
1287 | ||
1288 | C\bCO\bOP\bPY\bYR\bRI\bIG\bGH\bHT\bT | |
1289 | Copyright 1993, 1994 Harald Albrecht. | |
1290 | ||
1291 | The ComboBox widget is free software; you can redistribute | |
1292 | it and/or modify it under the terms of the GNU General | |
1293 | Public License as published by the Free Software Founda- | |
1294 | tion; either version 2, or (at your option) any later ver- | |
1295 | sion. | |
1296 | ||
1297 | ||
1298 | ||
1299 | A\bAV\bVA\bAI\bIL\bLA\bAB\bBI\bIL\bLI\bIT\bTY\bY | |
1300 | The most recent released version of the ComboBox widget is | |
1301 | always available for anonymous ftp from either | |
1302 | ||
1303 | ftp.x.org (198.112.44.100) | |
1304 | /contrib/widgets/motif/ComboBox | |
1305 | ||
1306 | or from | |
1307 | ||
1308 | ftp.informatik.rwth-aachen.de (137.226.112.172) | |
1309 | /pub/packages/ComboBox | |
1310 | ||
1311 | ||
1312 | ||
1313 | A\bAU\bUT\bTH\bHO\bOR\bR | |
1314 | Author of Software & Documentation: | |
1315 | ||
1316 | ||
1317 | ||
1318 | Version 1.31 20 March 1995 20 | |
1319 | ||
1320 | ||
1321 | ||
1322 | ||
1323 | ||
1324 | XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm) | |
1325 | ||
1326 | ||
1327 | Harald Albrecht | |
1328 | Institut fuer Geometrie und Praktische Mathematik | |
1329 | RWTH Aachen, Bundesrepublik Deutschland | |
1330 | e-mail: albrecht@igpm.rwth-aachen.de | |
1331 | ||
1332 | English Documentation: | |
1333 | Chris Marotz | |
1334 | Sterling Software ITD | |
1335 | e-mail: marotz@itd.sterling.com | |
1336 | ||
1337 | ||
1338 | ||
1339 | R\bRE\bEL\bLA\bAT\bTE\bED\bD I\bIN\bNF\bFO\bOR\bRM\bMA\bAT\bTI\bIO\bON\bN | |
1340 | "_\bT_\bh_\be _\bC_\bo_\bm_\bb_\bo_\bB_\bo_\bx _\bW_\bi_\bd_\bg_\be_\bt" documentation | |
1341 | C\bCo\bor\bre\be(\b(3\b3X\bX)\b), X\bXm\bmC\bCo\bom\bmp\bpo\bos\bsi\bit\bte\be(\b(3\b3X\bX)\b), X\bXm\bmL\bLi\bis\bst\bt(\b(3\b3X\bX)\b), X\bXm\bmT\bTe\bex\bxt\btF\bFi\bie\bel\bld\bd(\b(3\b3X\bX)\b) | |
1342 | _\bD_\bo_\bu_\bg_\bl_\ba_\bs _\bA_\bd_\ba_\bm_\bs_\b: _\bT_\bh_\be _\bH_\bi_\bt_\bc_\bh_\bh_\bi_\bk_\be_\br_\b'_\bs _\bG_\bu_\bi_\bd_\be _\bt_\bo _\bt_\bh_\be _\bG_\ba_\bl_\ba_\bx_\by_\b. | |
1343 | f\bfi\bil\ble\be:\b:/\b//\b/1\b13\b34\b4.\b.1\b13\b30\b0.\b.1\b16\b61\b1.\b.3\b30\b0/\b/a\bar\brc\bc/\b/p\bpu\bub\bb/\b/u\bun\bni\bix\bx/\b/h\bht\btm\bml\bl/\b/m\bmo\bot\bti\bif\bfc\bco\bor\brn\bne\ber\br.\b.h\bht\btm\bml\bl | |
1344 | ||
1345 | ||
1346 | ||
1347 | ||
1348 | ||
1349 | ||
1350 | ||
1351 | ||
1352 | ||
1353 | ||
1354 | ||
1355 | ||
1356 | ||
1357 | ||
1358 | ||
1359 | ||
1360 | ||
1361 | ||
1362 | ||
1363 | ||
1364 | ||
1365 | ||
1366 | ||
1367 | ||
1368 | ||
1369 | ||
1370 | ||
1371 | ||
1372 | ||
1373 | ||
1374 | ||
1375 | ||
1376 | ||
1377 | ||
1378 | ||
1379 | ||
1380 | ||
1381 | ||
1382 | ||
1383 | ||
1384 | Version 1.31 20 March 1995 21 | |
1385 | ||
1386 |