bionic (3) XmImGetXIC.3.gz

Provided by: libmotif-dev_2.3.8-2build1_amd64 bug

NAME

       XmImGetXIC  —  An  input  manager  function  that obtains an XIC for a widget "XmImGetXIC" "input manager
       functions" "XmImGetXIC"

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.

       XmImSetXIC(3) and XmImFreeXIC(3).

                                                                                                   XmImGetXIC(3)