NAME

       XmImSetValues  —  An  input  manager  function that updates attributes of an input context
       "XmImSetValues" "input manager functions" "XmImSetValues"

SYNOPSIS

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

DESCRIPTION

       XmImSetValues updates attributes of  the  input  context  associated  with  the  specified
       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 initial call  to  this
       routine  should  pass in all of the input context attributes.  Thereafter, the application
       programmer calls XmImSetValues, for an XIC, only if a value has changed.

       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.

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

       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;  the
                 following       attributes       are      accepted:      XmNpreeditStartCallback
                 XmNpreeditDoneCallback XmNpreeditDrawCallback and XmNpreeditCaretCallback. These
                 attributes  accept  an  accompanying  value of type pointer to structure of type
                 XIMCallback.

                 These callbacks are used only when the XmNpreeditType resource of  the  relevant
                 VendorShell   has   the   "onthespot"   value,   and   that   the  XIM  supports
                 XIMPreeditCallbacks input style. These values are ignored if  the  condition  is
                 not met.

                 For  each of these callbacks, if the callback value is not set by this function,
                 no action will be taken when the Input  Method  tries  to  call  this  callback.
                 Refer  to  the "Xlib - C Language X Interface, X Version 11, Release 6," Chapter
                 13 for the detail of these callbacks.

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

       Resources that can be set for the input context include:

       XmNbackground
                 Specifies the pixel value for the background color.

       XmNbackgroundPixmap
                 Specifies a pixmap for tiling the background.

       XmNfontList
                 Specifies the font list used by the widget. The  input  method  uses  the  first
                 occurrence of a font set tagged with XmFONTLIST_DEFAULT_TAG. If no such instance
                 is found, the first font set in the font list is used. If the font list does not
                 contain a font set, a value is not passed to XICSetValues.

       XmNforeground
                 Specifies the pixel value for the foreground color.

       XmNlineSpace
                 Specifies the line spacing used in the pre-edit window.

       XmNrenderTable
                 Specifies the render table used by the widget.

       XmNspotLocation
                 Specifies the x and y coordinates of the position where text will be inserted in
                 the widget handling input, whose input method  style  is  "OverTheSpot".  The  y
                 coordinate is the position of the baseline used by the current text line.

       The  caller  may  also  pass  any  other  vendor-defined  resources  to this function. For
       additional information on the internationalization interface, see the Xlib documentation.

RELATED

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

                                                                                 XmImSetValues(3)