NAME

       XmImSetFocusValues  —  An  input  manager  function  that notifies an input manager that a
       widget  has  received   input   focus   and   updates   the   input   context   attributes
       "XmImSetFocusValues" "input manager functions" "XmImSetFocusValues"

SYNOPSIS

       #include <Xm/XmIm.h>
       void XmImSetFocusValues(
       Widget widget,
       ArgList arglist,
       Cardinal argcount,
       );

DESCRIPTION

       XmImSetFocusValues notifies the input manager that the specified widget has received input
       focus. This function also updates the attributes of the input context associated with  the
       widget.  The  focus  window  for  the  XIC is set to the window of the widget. The arglist
       argument is a list of attribute/value pairs for the input context.  This  function  passes
       the  attributes and values to XICSetValues. The caller of this routine should pass in only
       those  values  that  have  changed  since  the  last  call  to  any  of  these  functions;
       XmImSetValues,  XmImSetFocusValues,  XmImVaSetValues,  or  XmImVaSetFocusValues.  See  the
       description in the XmImSetValues(3) reference page for a list of associated resources.

       If the previous parameters for the widget's XIC do not allow the previously registered XIC
       to  be reused, that XIC will be unregistered, and a new one will be created and registered
       with the widget. Note that sharing of data is preserved.

       widget    Specifies the ID of the widget registered with the input manager.

       arglist   Specifies the list of attribute/value pairs to be passed  to  XICSetValues.  See
                 the description in the XmImSetValues(3) man page for a description of resources.

       argcount  Specifies the number of attribute/values pairs in the argument list (arglist)

       Note  that  the  Text and TextField widgets call the XmImSetFocusValues function when they
       receive focus. Therefore, further calls  to  the  XmImSetFocusValues  function  for  these
       widgets are unnecessary.

RELATED

       XmImSetValues(3), XmImVaSetFocusValues(3), and XmImVaSetValues(3).

                                                                            XmImSetFocusValues(3)