XGetICValues − get input context attributes.
Synopsis
char * XGetICValues(ic, ...)
XIC ic;
Arguments
icSpecifies the input context.
...Specifies the variable length argument list to set or get XIC values.
Availability
Release 5 and later.
Description
XGetICValues() queries the values of input context attributes. The first argument is the input context, and it is followed by a NULL-terminated variable-length argument list of attribute name/value pairs. The standard attributes and their types are listed in the tables below. Input Context Attributes
| Name | Type | Notes | ||
| XNInputStyle | XIMStyle | Required at IC creation; may not be changed. | ||
| XNClientWindow | Window | Must be set before IC use; may not be changed. | ||
| XNFocusWindow | Window | Changes may cause geometry negotiation. | ||
| XNResourceClass | char * | |||
| XNGeometryCallback | XIMCallback * | |||
| XNFilterEvents | unsigned long | Read-only attribute; may not be set. | ||
| XNPreeditAttributes | XVaNestedList | See sub-attributes below. | ||
| XNStatusAttributes | XVaNestedList | See sub-attributes below. |
Preedit and Status Area Sub-attributes
| Name | Type | Notes | ||
| XNArea | XRectangle * | |||
| XNAreaNeeded | XRectangle * | |||
| XNSpotLocation | XPoint * | Required at IC creation for XIMPreeditPosition style. | ||
| XNColormap | Colormap |
Preedit and Status Area Sub-attributes (Continued)
| Name | Type | Notes | ||
| XNStdColormap | Atom | |||
| XNForeground | unsigned long | |||
| XNBackground | unsigned long | |||
| XNBackgroundPixmap | Pixmap | |||
| XNFontSet | XFontSet | Required at IC creation; changes may cause geometry negotiation. | ||
| XNLineSpacing | int | Changes may cause geometry negotiation. | ||
| XNCursor | Cursor | |||
| XNPreeditStartCallback | XIMCallback * | Required at IC creation for XIMPreeditCallbacks style. | ||
| XNPreeditDoneCallback | XIMCallback * | Required at IC creation for XIMPreeditCallbacks style. | ||
| XNPreeditDrawCallback | XIMCallback * | Required at IC creation for XIMPreeditCallbacks style. | ||
| XNPreeditCaretCallback | XIMCallback * | Required at IC creation for XIMPreeditCallbacks style. | ||
| XNStatusStartCallback | XIMCallback * | Required at IC creation for XIMStatusCallbacks style. | ||
| XNStatusDoneCallback | XIMCallback * | Required at IC creation for XIMStatusCallbacks style. | ||
| XNStatusDrawCallback | XIMCallback * | Required at IC creation for XIMStatusCallbacks style. |
In addition to the attribute names above, the special name XNVaNestedList indicates that the following argument is a XVaNestedList of attribute name/value pairs. When a nested list is encountered in an argument list, the contents of the nested list are processed as if they appeared in the original argument list at that point. The XGetICValues() function returns NULL if no error occurred; otherwise, it returns the name of the first attribute that could not be obtained. An attribute could be not obtained for any of the following reasons:
•The attribute name is not recognized.
•The input method encountered an implementation dependent error. Each attribute value argument to XGetICValues() (the argument that follows the attribute name) must be the address of a location into which the value is to be stored. For attributes that are pointer types (XNArea, for example), XGetICValues() returns a pointer to a copy of the attribute value. In this case, the client must free the memory allocated for that copy with XFree().
See Also
XCreateIC(), XOpenIM(), XSetICFocus(), XSetICValues(), XmbResetIC(), XwcResetIC.
Copyright O’Reilly & Assoc. —