4 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
8 XmComboBox - The Combo Box widget class
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>
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.
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.
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.
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.
35 The class name is X
\bXm
\bmC
\bCo
\bom
\bmb
\bbo
\boB
\bBo
\box
\bx.
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).
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 -----------------------------------------------------------------
64 Version 1.31 20 March 1995 1
70 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
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 -----------------------------------------------------------------
84 -----------------------------------------------------------------
85 XmNcolumns dynamic CSG
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 -----------------------------------------------------------------
108 -----------------------------------------------------------------
109 XmNfontList dynamic CSG
110 XmCFontList XmFontList
111 -----------------------------------------------------------------
114 -----------------------------------------------------------------
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
130 Version 1.31 20 March 1995 2
136 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
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
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 -----------------------------------------------------------------
175 XmCListSpacing Dimension
176 -----------------------------------------------------------------
177 XmNmarginHeight 5 CSG
178 XmCMarginHeight Dimension
179 -----------------------------------------------------------------
181 XmCMarginWidth Dimension
182 -----------------------------------------------------------------
183 XmNmaxLength largest integer CSG
185 -----------------------------------------------------------------
186 XmNmodifyVerifyCallback NULL CSG
187 XmCCallback XtCallbackList
188 -----------------------------------------------------------------
189 XmNmotionVerifyCallback NULL CSG
190 XmCCallback XtCallbackList
191 -----------------------------------------------------------------
196 Version 1.31 20 March 1995 3
202 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
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
222 -----------------------------------------------------------------
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 -----------------------------------------------------------------
249 -----------------------------------------------------------------
250 XmNvalueChangedCallback NULL CSG
251 XmCCallback XtCallbackList
252 -----------------------------------------------------------------
253 XmNvisibleItemCount 8 CSG
254 XmCVisibleItemCount Int
255 -----------------------------------------------------------------
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
262 Version 1.31 20 March 1995 4
268 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
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.
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.
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.
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
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.
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
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.
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.
328 Version 1.31 20 March 1995 5
334 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
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.
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.
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.
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.
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.
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
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.
384 X
\bXm
\bmN
\bNi
\bit
\bte
\bem
\bmC
\bCo
\bou
\bun
\bnt
\bt
385 Specifies the total number of items in the list.
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
394 Version 1.31 20 March 1995 6
400 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
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
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-
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).
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
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.
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.
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.
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.
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.
460 Version 1.31 20 March 1995 7
466 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
469 X
\bXm
\bmN
\bNl
\bli
\bis
\bst
\btS
\bSp
\bpa
\bac
\bci
\bin
\bng
\bg
470 The spacing between items in the list.
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
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.
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.
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.
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.
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
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
526 Version 1.31 20 March 1995 8
532 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
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
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.)
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
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
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).
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-
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
592 Version 1.31 20 March 1995 9
598 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
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-
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
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
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.
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).
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.
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).
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.
658 Version 1.31 20 March 1995 10
664 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
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.
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.
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:
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;
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
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.
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:
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;
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-
713 _
\be_
\bv_
\be_
\bn_
\bt Points to the X
\bXE
\bEv
\bve
\ben
\bnt
\bt, which triggered the
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:
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;
724 Version 1.31 20 March 1995 11
730 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
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;
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.
752 _
\be_
\bv_
\be_
\bn_
\bt Points to the X
\bXE
\bEv
\bve
\ben
\bnt
\bt, which triggered the
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!
760 _
\bi_
\bn_
\bd_
\be_
\bx Index (starting from 1) of the currently
761 selected item in the list.
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:
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;
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.
774 _
\be_
\bv_
\be_
\bn_
\bt Points to the X
\bXE
\bEv
\bve
\ben
\bnt
\bt, which triggered the
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-
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;
790 Version 1.31 20 March 1995 12
796 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
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;
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.
808 _
\be_
\bv_
\be_
\bn_
\bt Points to the X
\bXE
\bEv
\bve
\ben
\bnt
\bt, which triggered the
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
816 _
\bc_
\bu_
\br_
\br_
\bI_
\bn_
\bs_
\be_
\br_
\bt Specifies the current position of the
819 Indicates the position at which the user
820 attempts to position the cursor.
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.
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.
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.
838 The following table describes the reasons why the individ-
839 ual verification callback structure fields are valid.
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
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,
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;
856 Version 1.31 20 March 1995 13
862 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
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;
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.
874 _
\be_
\bv_
\be_
\bn_
\bt Contains always N
\bNU
\bUL
\bLL
\bL and is just there for
875 compatibility reasons.
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.
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".
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).
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.
902 The following table describes which individual callback
903 structure fields are valid during which operations.
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
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".
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
922 Version 1.31 20 March 1995 14
928 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
931 the behavior and contents of its children.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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)
988 Version 1.31 20 March 1995 15
994 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
997 See X
\bXm
\bmL
\bLi
\bis
\bst
\btR
\bRe
\bep
\bpl
\bla
\bac
\bce
\beI
\bIt
\bte
\bem
\bms
\bsP
\bPo
\bos
\bs.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
1054 Version 1.31 20 March 1995 16
1060 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
1120 Version 1.31 20 March 1995 17
1126 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
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.
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.
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.
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
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
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.
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
1181 On some other window managers like twm you will face
1182 another problem: the list gets hidden as soon as the mouse
1186 Version 1.31 20 March 1995 18
1192 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
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-
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).
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.
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;
1217 Somewhere in your program you'll need something like the
1218 following code fragment:
1223 ComboBox = XtVaCreateManagedWidget("combobox",
1224 xmComboBoxWidgetClass, Parent,
1225 XmNeditable, True or False,
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.
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).
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
1246 XmComboBoxSelectPos(ComboBox, item #, False);
1252 Version 1.31 20 March 1995 19
1258 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
1261 XmComboBoxSelectItem(ComboBox, itemString, False);
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.
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
1273 XmComboBoxSetString(ComboBox, string);
1275 This sets the contents of the text input field to string.
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
1288 C
\bCO
\bOP
\bPY
\bYR
\bRI
\bIG
\bGH
\bHT
\bT
1289 Copyright 1993, 1994 Harald Albrecht.
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-
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
1303 ftp.x.org (198.112.44.100)
1304 /contrib/widgets/motif/ComboBox
1308 ftp.informatik.rwth-aachen.de (137.226.112.172)
1309 /pub/packages/ComboBox
1313 A
\bAU
\bUT
\bTH
\bHO
\bOR
\bR
1314 Author of Software & Documentation:
1318 Version 1.31 20 March 1995 20
1324 XmComboBox(3Xm) Harry's Motif Tools XmComboBox(3Xm)
1328 Institut fuer Geometrie und Praktische Mathematik
1329 RWTH Aachen, Bundesrepublik Deutschland
1330 e-mail: albrecht@igpm.rwth-aachen.de
1332 English Documentation:
1334 Sterling Software ITD
1335 e-mail: marotz@itd.sterling.com
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
1384 Version 1.31 20 March 1995 21
projects / wxWidgets.git / blob