Manual Pages for UNIX Operating System command usage for man XGetICValues

XLIB FUNCTIONS                                 XSetICValues(3x11)



NAME
     XSetICValues, XGetICValues - set and obtain XIC values

SYNTAX
     cc [ flag... ] file... -lX11 [ library... ]

     char * XSetICValues(XIC ic, ...);

     char * XGetICValues(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, XNFil-
          terEvents).

     +o    The argument name is not recognized.

     +o    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:

     +o    The argument name is not recognized.

     +o    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 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



X Version 11        Last change: libX11 1.3.5                   1






XLIB FUNCTIONS                                 XSetICValues(3x11)



     for an IC value of type XNVaNestedList (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),
     XmbResetIC(3x11)
     Xlib - C Language X Interface


ATTRIBUTES
     See attributes(5) for descriptions of the following attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | x11/library/libx11          |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | See XInitThreads(3X11)      |
    |_____________________________|_____________________________|














X Version 11        Last change: libX11 1.3.5                   2