Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for xmimsetvalues (redhat section 3)

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 wid-
       get. 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 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 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 unnec-
       essary.

       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  XmNpreeditDoneCall-
		 back 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 XIMPreeditCall-
		 backs 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  addi-
       tional information on the internationalization interface, see the Xlib documentation.

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

								      XmImSetValues(library call)


All times are GMT -4. The time now is 03:29 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password