XOpenIM, XCloseIM, XSetIMValues, XGetIMValues, XDisplay-
       OfIM, XLocaleOfIM, XRegisterIMInstantiateCallback, XUnreg-
       isterIMInstantiateCallback - open, close, and otain input
       method information


SYNTAX

       XIM XOpenIM(display, db, res_name, res_class)
             Display *display;
             XrmDatabase db;
             char *res_name;
             char *res_class;

       Status XCloseIM(im)
             XIM im;

       char * XSetIMValues(im, ...)
             XIM im;

       char * XGetIMValues(im, ...)
             XIM im;

       Display * XDisplayOfIM(im)
            XIM im;

       char * XLocaleOfIM(im)
             XIM im;

       Bool XRegisterIMInstantiateCallback(display, db, res_name,
       res_class, callback, client_data)
             Display *display;
             XrmDatabase db;
             char *res_name;
             char *res_class;
             XIMProc  callback;
             XPointer *client_data;

       Bool XUnregisterIMInstantiateCallback(display, db,
       res_name, res_class, callback, client_data)
             Display *display;
             XrmDatabase db;
             char *res_name;
             char *res_class;
             XIMProc  callback;
             XPointer *client_data;



ARGUMENTS

       callback  Specifies a pointer to the input method instan-
                 tiate callback.

       client_data
                 Specifies the additional client data.
                 set or get XIM values.


DESCRIPTION

       The XOpenIM function opens an input method, matching the
       current locale and modifiers specification.  Current
       locale and modifiers are bound to the input method at
       opening time.  The locale associated with an input method
       cannot be changed dynamically.  This implies that the
       strings returned by XmbLookupString or XwcLookupString,
       for any input context affiliated with a given input method
       will be encoded in the locale current at the time the
       input method is 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 for the input method 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 database 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 Char-
       acter Set.  The resources looked up are not fully speci-
       fied 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.

       The XCloseIM function closes the specified input method.

       The XSetIMValues function presents a variable argument
       list programming interface for setting attributes of the
       specified input method.  It returns NULL if it succeeds;
       otherwise, it returns the name of the first argument that
       could not be set.  Xlib does not attempt to set arguments
       from the supplied list that follow the failed argument;
       all arguments in the list preceding the failed argument
       have been set correctly.

       The XDisplayOfIM function returns the display associated
       with the specified input method.

       The XLocaleOfIM function returns the locale associated
       with the specified input method.

       The XRegisterIMInstantiateCallback function registers a
       callback to be invoked whenever a new input method becomes
       available for the specified display that matches the cur-
       rent locale and modifiers.

       The function returns True
        if it succeeds; otherwise, it returns False.

       The XUnregisterIMInstantiateCallback function removes an
       input method instantiation callback previously registered.
       The function returns True if it succeeds; otherwise, it
       returns False.


SEE ALSO

       XCreateIC(3X11), XSetICFocus(3X11), XSetICValues(3X11),
       XmbResetIC(3X11)
       Xlib - C Language X Interface



X Version 11               Release 6.4                          1