NAME

       XmImRegister  —  An  input  manager function that registers a widget with an input manager
       "XmImRegister" "input manager functions" "XmImRegister"

SYNOPSIS

       #include <Xm/XmIm.h>
       void XmImRegister(
       Widget widget,
       unsigned int reserved);

DESCRIPTION

       XmImRegister registers a widget with its input manager.  This adds the specified widget to
       a  list  of  widgets  that  are supported by the input manager for an input method.  If an
       input method has not been opened by a previous call to XmImRegister, the first  time  this
       routine  is  called  it  opens  an  input method using the XmNinputMethod resource for the
       VendorShell. If the XmNinputMethod is NULL, an input method is opened  using  the  current
       locale.

       If  an  input  method cannot be opened in the current locale, XLookupString provides input
       processing.

       The application is responsible for unregistering a widget by calling XmImUnregister.

       Note that the Text, TextField, and List widgets already  call  the  XmImRegister  function
       internally.   You  should  not  call  this  function  for  these  widgets  before  calling
       XmImUnregister first.

       widget    Specifies the ID of the widget to be registered.

       reserved  This argument is not used in the current release of  Motif.   The  value  should
                 always be 0 (zero).

RELATED

       XmImGetXIM(3), XmImMbLookupString(3), and XmImUnregister(3).

                                                                                  XmImRegister(3)