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