XSetICValues, XGetICValues - set and obtain XIC values
SYNTAX
char * XSetICValues(ic, ...)
XIC ic;
char * XGetICValues(ic, ...)
XIC ic;
ARGUMENTS
ic Specifies the input context.
... Specifies the variable length argument list to
set or get XIC values.
DESCRIPTION
The XSetICValues function returns NULL if no error
occurred; otherwise, it returns the name of the first
argument that could not be set. An argument might not be
set for any of the following reasons:
o The argument is read-only (for example,
XNFilterEvents).
o The argument name is not recognized.
o An implementation-dependent error occurs.
Each value to be set must be an appropriate datum, match-
ing the data type imposed by the semantics of the argu-
ment.
The XSetICValues can generate BadAtom, BadColor,
BadCursor, BadPixmap, and BadWindow errors.
The XGetICValues function returns NULL if no error
occurred; otherwise, it returns the name of the first
argument that could not be obtained. An argument could
not be obtained for any of the following reasons:
o The argument name is not recognized.
o The input method encountered an implementation-depen-
dent error.
Each IC attribute value argument (following a name) must
point to a location where the IC value is to be stored.
That is, if the IC value is of type T, the argument must
be of type T*. If T itself is a pointer type, then XGet-
ICValues allocates memory to store the actual data, and
the client is responsible for freeing this data by calling
XFree with the returned pointer. The exception to this
BadCursor A value for a Cursor argument does not name a
defined Cursor.
BadPixmap A value for a Pixmap argument does not name a
defined Pixmap.
BadWindow A value for a Window argument does not name a
defined Window.
SEE ALSO
XCreateIC(3X11), XOpenIM(3X11), XSetICFocus(3X11), XmbRe-
setIC(3X11)
Xlib - C Language X Interface
X Version 11 Release 6.4 1