XmImGetXIC(library call) XmImGetXIC(library call)

NAME

XmImGetXIC -- An input manager function that obtains an XIC for a
widget

SYNOPSIS

#include <Xm/XmIm.h>
XIC XmImGetXIC(
Widget widget,
XmInputPolicy input_policy,
ArgList args,
Cardinal num_args);

DESCRIPTION

XmImGetXIC creates and registers an X Input Context (XIC) with the
specified arguments for widget. If XmINHERIT_POLICY is specified for
input_policy, a new XIC will be created only if required to by the
arguments or by the VendorShell input policy. Any existing XIC
registered with widget is unregistered.

Refer to the VendorShell reference page for further details.

widget Specifies the ID of a widget for which an Input Context is
to be created.

input_policy
Specifies the type of input policy. It accepts the
following values:

XmINHERIT_POLICY
Inherits the policy from VendorShell.

XmPER_WIDGET
Creates a new XIC for this widget.

XmPER_SHELL
Creates a new XIC for the shell, if needed.

args Specifies an XtArgList parameter to use for creating the
XIC.

num_args Specifies the number of arguments in the args parameter.

RETURN

Returns the created XIC. The application is responsible for freeing
the returned XIC by calling XmImFreeXIC.

RELATED

XmImSetXIC(3) and XmImFreeXIC(3).

XmImGetXIC(library call)