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 input_policy,
ArgList args,
Cardinal num_args);
VERSION
This page documents Motif 2.1.
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.
Page 1 (printed 7/20/06)
XmImGetXIC(3X) UNIX System V XmImGetXIC(3X)
RELATED
XmImSetXIC(3) and XmImFreeXIC(3).
Page 2 (printed 7/20/06)