XCreateIC()XCreateIC()NameXCreateIC – create an input context.
Synopsis
XIC XCreateIC(im, ...)
XIM im;
Arguments
im Specifies the input method.
... Specifies the variable length argument list to set XIC val‐
ues.
Returns
The created input context.
Availability
Release 5 and later.
DescriptionXCreateIC() creates an input context associated with the specified
input method. The first argument to this function is the "parent"
input method, and it is followed by a NULL-terminated variable-length
argument list of input context attribute name/value pairs. The tables
below list the standard attribute names and their types. Note that the
XNInputStyle attribute and XNFontSet sub-attribute for the Preedit and
Status areas must be specified when the IC is created. XNSpotLocation
must be specified for the Preedit area if the pre-edit interaction
style is XIMPreeditPosition. All the Preedit and Status callbacks must
be specified in the call to XCreateIC() if the interaction style is
XIMPreeditCallbacks or XIMStatusCallbacks. Any other attributes may be
set with XCreateIC(), but are not required.
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.
XNResourceName char *
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.
Pre-edit and Status Area Sub-attributes
Name Type Notes
XNArea XRectangle *
XNAreaNeeded XRectangle *
XNSpotLocation XPoint * Required at IC
creation for
XIMPreeditPosi‐
tion style.
XNColormap Colormap
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
XIMPreeditCall‐
backs style.
XNPreeditDoneCallback XIMCallback * Required at IC
creation for
XIMPreeditCall‐
backs style.
XNPreeditDrawCallback XIMCallback * Required at IC
creation for
XIMPreeditCall‐
backs style.
XNPreeditCaretCallback XIMCallback * Required at IC
creation for
XIMPreeditCall‐
backs style.
XNStatusStartCallback XIMCallback * Required at IC
creation for
XIMStatusCall‐
backs style.
XNStatusDoneCallback XIMCallback * Required at IC
creation for
XIMStatusCall‐
backs style.
XNStatusDrawCallback XIMCallback * Required at IC
creation for
XIMStatusCall‐
backs style.
In addition to the attribute names above, the special name XNVaNest‐
edList 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.
XCreateIC() returns a NULL value if no input context could be created.
A NULL value could be returned for any of the following reasons:
· A required argument was not set.
· A read-only argument was set (for example, XNFilterEvents).
· The argument name is not recognized.
· The input method encountered an implementation-dependent error.
Errors
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 Col‐
ormap.
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 AlsoXOpenIM(), XSetICFocus(), XSetICValues(), XDestroyIC(), XIMOfIC(),
XmbResetIC(), XwcResetIC().
Xlib - Input Contexts XCreateIC()