Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
XmImSetValues(3)	   Library Functions Manual	      XmImSetValues(3)

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

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

       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  pro-
       grammer calls XmImSetValues, for	an XIC,	only if	a value	has changed.

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

       Note that the Text and TextField	widgets	call the  XmImSetValues	 func-
       tion  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 man-

       arglist	 Specifies  the	 list of attribute/value pairs to be passed to
		 XICSetValues; the following  attributes  are  accepted:  XmN-
		 preeditStartCallback  XmNpreeditDoneCallback  XmNpreeditDraw-
		 Callback and XmNpreeditCaretCallback. These attributes	accept
		 an  accompanying  value  of type pointer to structure of type

		 These callbacks are used only	when  the  XmNpreeditType  re-
		 source	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 argu-
		 ment list (arglist)

       Resources that can be set for the input context include:

		 Specifies the pixel value for the background color.

		 Specifies a pixmap for	tiling the background.

		 Specifies the font list used by the widget. The input	method
		 uses  the  first  occurrence  of  a  font set tagged with Xm-
		 FONTLIST_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.

		 Specifies the pixel value for the foreground color.

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

		 Specifies the render table used by the	widget.

		 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	 posi-
		 tion 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.

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



Want to link to this manual page? Use this URL:

home | help