XmImGetXIC(3X) UNIX System V XmImGetXIC(3X)
NAME
XmImGetXIC - An input manager function that obtains an XIC
for a widget
SYNOPSIS
#include <Xm/XmIm.h>
XIC XmImGetXIC(
Widget widget,
XmInputPolicy inputpolicy,
ArgList args,
Cardinal numargs);
VERSION
This page documents Motif 2.1.
DESCRIPTION
XmImGetXIC creates and registers an X Input Context (XIC)
with the specified arguments for widget. If XmINHERITPOLICY
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:
XmINHERITPOLICY
Inherits the policy from VendorShell.
XmPERWIDGET
Creates a new XIC for this widget.
XmPERSHELL
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.
Page 1 (printed 1/22/99)
XmImGetXIC(3X) UNIX System V XmImGetXIC(3X)
RELATED
XmImSetXIC(3) and XmImFreeXIC(3).
Page 2 (printed 1/22/99)