XGetIMValues − obtain input method information.
Synopsis
char * XGetIMValues(im, ...)
XIM im;
Arguments
imSpecifies the input method.
...Specifies the variable length argument list to get XIM values.
Availability
Release 5 and later.
Description
XGetIMValues() queries the values of input method attributes. The first argument is the input method, and it is followed by a NULL-terminated variable-length argument list of attribute name/value pairs. Only one standard attribute is defined by Xlib: XNQueryInputStyle. It is of type XIMStyles * (shown below) and is used to query the input styles supported by the input method. A client should always query the input method to determine which styles are supported. The client should then find an input style it is capable of supporting, and use that style when creating input contexts. If the client cannot find an input style that it can support it should negotiate with the user the continuation of the program (exit, choose another input method, and so on). The attribute value argument (which follows the attribute name argument) must be the address of a location where the returned value will be stored. For the XNQueryInputStyle attribute, the client must pass the address of a variable of type XIMStyles *, and is responsible for freeing the memory allocated for the XIMStyles data structure with XFree(). XGetIMValues() returns NULL if it succeeds. Otherwise it returns the name of the first attribute for which a value could not be obtained.
Structures
#define XIMPreeditArea0x0001L
#define XIMPreeditCallbacks0x0002L
#define XIMPreeditPosition0x0004L
#define XIMPreeditNothing0x0008L
#define XIMPreeditNone0x0010L
#define XIMStatusArea0x0100L
#define XIMStatusCallbacks0x0200L
#define XIMStatusNothing0x0400L
#define XIMStatusNone0x0800L
typedef unsigned long XIMStyle;
typedef struct {
unsigned short count_styles;
XIMStyle *supported_styles;
} XIMStyles;
See Also
XOpenIM(), XCloseIM(), XDisplayOfIM(), XLocaleOfIM().
Copyright O’Reilly & Assoc. —