MirOS Manual: XGetICValues(3), XSetICValues(3)


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

NAME

     XSetICValues, XGetICValues - set and obtain XIC values

SYNTAX

     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:

     +    The argument is read-only (for example, XNFil-
          terEvents).

     +    The argument name is not recognized.

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

     +    The argument name is not recognized.

     +    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 XGetICValues
     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 XNVaNestedList (for preedit and status attri-
     butes). In this case,  the argument must also be of type

XFree86                   Version 4.5.0                         1

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

     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

XFree86                   Version 4.5.0                         2

Generated on 2017-04-03 16:26:17 by $MirOS: src/scripts/roff2htm,v 1.88 2017/01/29 00:51:06 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002–2017 The MirOS Project, Germany.
This product includes material provided by mirabilos.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.