1XSetICValues(3)                 XLIB FUNCTIONS                 XSetICValues(3)
2
3
4

NAME

6       XSetICValues, XGetICValues - set and obtain XIC values
7

SYNTAX

9       char * XSetICValues(XIC ic, ...);
10
11       char * XGetICValues(XIC ic, ...);
12

ARGUMENTS

14       ic        Specifies the input context.
15
16       ...       Specifies the variable length argument list to set or get XIC
17                 values.
18

DESCRIPTION

20       The XSetICValues function returns NULL if no error occurred; otherwise,
21       it  returns  the  name of the first argument that could not be set.  An
22       argument might not be set for any of the following reasons:
23
24       ·    The argument is read-only (for example, XNFilterEvents).
25
26       ·    The argument name is not recognized.
27
28       ·    An implementation-dependent error occurs.
29
30       Each value to be set must be an appropriate datum,  matching  the  data
31       type imposed by the semantics of the argument.
32
33       The  XSetICValues can generate BadAtom, BadColor, BadCursor, BadPixmap,
34       and BadWindow errors.
35
36       The XGetICValues function returns NULL if no error occurred; otherwise,
37       it  returns  the name of the first argument that could not be obtained.
38       An argument could not be obtained for any of the following reasons:
39
40       ·    The argument name is not recognized.
41
42       ·    The input method encountered an implementation-dependent error.
43
44       Each IC attribute value argument (following a name)  must  point  to  a
45       location  where the IC value is to be stored.  That is, if the IC value
46       is of type T, the argument must be of  type  T*.   If  T  itself  is  a
47       pointer  type,  then  XGetICValues allocates memory to store the actual
48       data, and the client is responsible for freeing this  data  by  calling
49       XFree  with the returned pointer.  The exception to this rule is for an
50       IC value of type XNVaNestedList (for preedit  and  status  attributes).
51       In  this case,  the argument must also be of type XVaNestedList.  Then,
52       the rule of changing type T  to  T*  and  freeing  the  allocated  data
53       applies to each element of the nested list.
54

DIAGNOSTICS

56       BadAtom   A value for an Atom argument does not name a defined Atom.
57
58       BadColor  A  value for a Colormap argument does not name a defined Col‐
59                 ormap.
60
61       BadCursor A value for a Cursor argument does not name a defined Cursor.
62
63       BadPixmap A value for a Pixmap argument does not name a defined Pixmap.
64
65       BadWindow A value for a Window argument does not name a defined Window.
66

SEE ALSO

68       XCreateIC(3), XOpenIM(3), XSetICFocus(3), XmbResetIC(3)
69       Xlib - C Language X Interface
70
71
72
73X Version 11                     libX11 1.6.12                 XSetICValues(3)
Impressum