1XmImSetValues(library call) XmImSetValues(library call)
2
6 XmImSetValues — An input manager function that updates attributes of an
7 input context
8
10 #include <Xm/XmIm.h>
11 void XmImSetValues(
12 Widget widget,
13 ArgList arglist,
14 Cardinal argcount,
15 );
16
18 XmImSetValues updates attributes of the input context associated with
19 the specified widget. The arglist argument is a list of attribute/value
20 pairs for the input context. This function passes the attributes and
21 values to XICSetValues. The initial call to this routine should pass in
22 all of the input context attributes. Thereafter, the application pro‐
23 grammer calls XmImSetValues, for an XIC, only if a value has changed.
24 If the previous parameters for the widget's XIC do not allow the previ‐
26 ously registered XIC to be reused, that XIC will be unregistered, and a
27 new one will be created and registered with the widget. Note that shar‐
28 ing of data is preserved.
29 Note that the Text and TextField widgets call the XmImSetValues func‐
31 tion when they receive focus. Therefore, further calls to the XmImSet‐
32 Values function for these widgets are unnecessary.
33 widget Specifies the ID of the widget registered with the input man‐
35 ager
36 arglist Specifies the list of attribute/value pairs to be passed to
38 XICSetValues; the following attributes are accepted: XmN‐
39 preeditStartCallback XmNpreeditDoneCallback XmNpreeditDraw‐
40 Callback and XmNpreeditCaretCallback. These attributes accept
41 an accompanying value of type pointer to structure of type
42 XIMCallback.
43 These callbacks are used only when the XmNpreeditType
45 resource of the relevant VendorShell has the "onthespot"
46 value, and that the XIM supports XIMPreeditCallbacks input
47 style. These values are ignored if the condition is not met.
48 For each of these callbacks, if the callback value is not set
50 by this function, no action will be taken when the Input
51 Method tries to call this callback. Refer to the "Xlib - C
52 Language X Interface, X Version 11, Release 6," Chapter 13
53 for the detail of these callbacks.
54 argcount Specifies the number of attribute/values pairs in the argu‐
56 ment list (arglist)
57 Resources that can be set for the input context include:
59 XmNbackground
61 Specifies the pixel value for the background color.
62 XmNbackgroundPixmap
64 Specifies a pixmap for tiling the background.
65 XmNfontList
67 Specifies the font list used by the widget. The input method
68 uses the first occurrence of a font set tagged with
69 XmFONTLIST_DEFAULT_TAG. If no such instance is found, the
70 first font set in the font list is used. If the font list
71 does not contain a font set, a value is not passed to XICSet‐
72 Values.
73 XmNforeground
75 Specifies the pixel value for the foreground color.
76 XmNlineSpace
78 Specifies the line spacing used in the pre-edit window.
79 XmNrenderTable
81 Specifies the render table used by the widget.
82 XmNspotLocation
84 Specifies the x and y coordinates of the position where text
85 will be inserted in the widget handling input, whose input
86 method style is "OverTheSpot". The y coordinate is the posi‐
87 tion of the baseline used by the current text line.
88 The caller may also pass any other vendor-defined resources to this
90 function. For additional information on the internationalization inter‐
91 face, see the Xlib documentation.
92
94 XmImSetFocusValues(3), XmImVaSetFocusValues(3), and XmImVaSetValues(3).
95 XmImSetValues(library call)