xmimsetvalues(3) [redhat man page]

XmImSetValues(library call)											       XmImSetValues(library call)

NAME

       XmImSetValues -- An input manager function that updates attributes of an input context

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  rou-
       tine 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 XmImSet-
       Values 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: XmNpreeditStart-
		 Callback 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 con-
		 tain 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 inter-
       face, see the Xlib documentation.

RELATED

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

														       XmImSetValues(library call)