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