GetIMValues(3X) — DeltaWindows 1.3.3 Release 4 Version 4.3

NAME

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.

RETURNS

NULL if no error occurred; otherwise, the name of the first attribute that could not be obtained.

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 XIMPreeditArea        0x0001L #define XIMPreeditCallbacks   0x0002L #define XIMPreeditPosition    0x0004L #define XIMPreeditNothing     0x0008L #define XIMPreeditNone        0x0010L #define XIMStatusArea         0x0100L #define XIMStatusCallbacks    0x0200L #define XIMStatusNothing      0x0400L #define XIMStatusNone         0x0800L

typedef unsigned long XIMStyle;

typedef struct {
    unsigned short count_styles;
    XIMStyle ∗supported_styles; } XIMStyles;

Museum