XSetICValues(3X11)XSetICValues(3X11)NAME
XSetICValues, XGetICValues - set and obtain XIC values
SYNOPSIS
char * XSetICValues(ic, ...)
XIC ic;
char * XGetICValues(ic, ...)
XIC ic;
ARGUMENTS
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: The argu‐
ment is read-only (for example, XNFilterEvents). The argument name is
not recognized. An implementation-dependent error occurs.
Each value to be set must be an appropriate datum, matching the data
type imposed by the semantics of the argument.
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: The
argument name is not recognized. The input method encountered an
implementation-dependent 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 XGetICValues 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 rule is for an IC value of
type XVaNestedList (for preedit and status attributes). In this case,
the argument must also be of type XVaNestedList. Then, the rule of
changing type T to T* and freeing the allocated data applies to each
element of the nested list.
DIAGNOSTICS
A value for an Atom argument does not name a defined Atom. A value for
a Colormap argument does not name a defined Colormap. A value for a
Cursor argument does not name a defined Cursor. A value for a Pixmap
argument does not name a defined Pixmap. A value for a Window argument
does not name a defined Window.
SEE ALSOXCreateIC(3X11), XOpenIM(3X11), XSetICFocus(3X11), XmbResetIC(3X11)
Xlib -- C Language X Interface
XSetICValues(3X11)