XOpenIM − open input method.
Synopsis
XIM XOpenIM(display, db, res_name, res_class)
Display *display;
XrmDatabase db;
char *res_name;
char *res_class;
Arguments
displaySpecifies the connection to the X server.
dbSpecifies the resource database.
res_nameSpecifies the full resource name of the application.
res_classSpecifies the full class name of the application.
Availability
Release 5 and later.
Description
XOpenIM() opens an input method. The current locale and modifiers are bound to the input method when it is opened. The locale associated with an input method cannot be changed dynamically. This implies the strings returned by XmbLookupString() or XwcLookupString(), for any input context affiliated with a given input method, will be encoded in the locale that was current at the time the input method was opened. The specific input method to which this call will be routed is identified on the basis of the current locale. XOpenIM() will identify a default input method corresponding to the current locale. That default can be modified using XSetLocaleModifiers() with the input method ("im") modifier. The db argument is the resource database to be used by the input method for looking up resources that are private to the input method. It is not intended that this database be used to look up values that can be set as IC values in an input context. If db is NULL, no data base is passed to the input method. The res_name and res_class arguments specify the resource name and class of the application. They are intended to be used as prefixes by the input method when looking up resources that are common to all input contexts that may be created for this input method. The characters used for resource names and classes must be in the X portable character set. The resources looked up are not fully specified if res_name or res_class is NULL. The res_name and res_class arguments are not assumed to exist beyond the call to XOpenIM(). The specified resource database is assumed to exist for the lifetime of the input method. XOpenIM() returns NULL if no input method could be opened.
See Also
XCloseIM(), XGetIMValues(), XDisplayOfIM(), XLocaleOfIM().
Copyright O’Reilly & Assoc. —