XSetICValues(3X11)        XLIB FUNCTIONS       XSetICValues(3X11)


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:

       o    A read-only argument was set (for example,
            XNFilterEvents).

       o    The argument name is not recognized.

       o    The input method encountered an input method imple-
            mentation dependent error.

       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 be
       not 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 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



X Version 11                Release 5                           1

XSetICValues(3X11)        XLIB FUNCTIONS       XSetICValues(3X11)


                 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), XmbRe-
       setIC(3X11)
       Xlib - C Language X Interface







































X Version 11                Release 5                           2