XSetICValues
Section: XLIB FUNCTIONS (3X11)
Updated: Release 5
Index
Return to Main Contents
NAME
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 could be not set for any of the following reasons:
- *
-
A read-only argument was set (for example,
XNFilterEvents).
- *
-
The argument name is not recognized.
- *
-
The input method encountered an input method implementation dependent error.
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 be not obtained for any of the following reasons:
- *
-
The argument name is not recognized.
- *
-
The input method encountered an implementation dependent error.
Each argument value
(following a name) must point to a location where the value is to be stored.
XGetICValues
allocates memory to store the values, and client is responsible for
freeing each value by calling
XFree.
DIAGNOSTICS
-
BadAtom
-
A value for an Atom argument does not name a defined Atom.
-
BadColor
-
A value for a Colormap argument does not name a defined Colormap.
-
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),
XmbResetIC(3X11)
Xlib - C Language X Interface
Index
- NAME
-
- SYNTAX
-
- ARGUMENTS
-
- DESCRIPTION
-
- DIAGNOSTICS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 07:03:34 GMT, May 19, 2025