[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Programmer's Reference


XmImRegister

An input manager function that registers a widget with an input manager

Format

#include <Xm/XmIm.h>
void XmImRegister
Widget
widgetunsigned 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).


[ Previous | Next | Contents | Glossary | Home | Search ]