]> git.saurik.com Git - wxWidgets.git/blame_incremental - src/motif/xmcombo/combobox.man
projects / wxWidgets.git / blame_incremental
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (non-incremental) | history | HEAD
Compilation fix for STL build after the last commit.
[wxWidgets.git] / src / motif / xmcombo / combobox.man
... / ...
CommitLineData
1
2
3
4XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
5
6
7N\bNA\bAM\bME\bE
8 XmComboBox - The Combo Box widget class
9
10S\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
18D\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
64Version 1.31 20 March 1995 1
65
66
67
68
69
70XmComboBox(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
130Version 1.31 20 March 1995 2
131
132
133
134
135
136XmComboBox(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
196Version 1.31 20 March 1995 3
197
198
199
200
201
202XmComboBox(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
262Version 1.31 20 March 1995 4
263
264
265
266
267
268XmComboBox(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
328Version 1.31 20 March 1995 5
329
330
331
332
333
334XmComboBox(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
394Version 1.31 20 March 1995 6
395
396
397
398
399
400XmComboBox(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
460Version 1.31 20 March 1995 7
461
462
463
464
465
466XmComboBox(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
526Version 1.31 20 March 1995 8
527
528
529
530
531
532XmComboBox(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
592Version 1.31 20 March 1995 9
593
594
595
596
597
598XmComboBox(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
658Version 1.31 20 March 1995 10
659
660
661
662
663
664XmComboBox(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
724Version 1.31 20 March 1995 11
725
726
727
728
729
730XmComboBox(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
790Version 1.31 20 March 1995 12
791
792
793
794
795
796XmComboBox(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
856Version 1.31 20 March 1995 13
857
858
859
860
861
862XmComboBox(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
922Version 1.31 20 March 1995 14
923
924
925
926
927
928XmComboBox(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
988Version 1.31 20 March 1995 15
989
990
991
992
993
994XmComboBox(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
1054Version 1.31 20 March 1995 16
1055
1056
1057
1058
1059
1060XmComboBox(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
1120Version 1.31 20 March 1995 17
1121
1122
1123
1124
1125
1126XmComboBox(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
1186Version 1.31 20 March 1995 18
1187
1188
1189
1190
1191
1192XmComboBox(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
1252Version 1.31 20 March 1995 19
1253
1254
1255
1256
1257
1258XmComboBox(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
1279B\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
1288C\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
1299A\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
1313A\bAU\bUT\bTH\bHO\bOR\bR
1314 Author of Software & Documentation:
1315
1316
1317
1318Version 1.31 20 March 1995 20
1319
1320
1321
1322
1323
1324XmComboBox(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
1339R\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
1384Version 1.31 20 March 1995 21
1385
1386
wxWidgets (Impactor)