Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

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)

Check Out this Related Man Page

XmCreateScrolledText(library call)										XmCreateScrolledText(library call)

NAME
XmCreateScrolledText -- The Text ScrolledText convenience creation function SYNOPSIS
#include <Xm/Text.h> Widget XmCreateScrolledText( Widget parent, String name, ArgList arglist, Cardinal argcount); DESCRIPTION
XmCreateScrolledText creates an instance of a Text widget that is contained within a ScrolledWindow. The ScrolledWindow parent is created managed. All ScrolledWindow subarea widgets are automatically created by this function. The ID returned by this function is that of the Text widget (not the ScrolledWindow widget). Use this widget ID for all operations on the Text widget. Use the widget ID of the Text wid- get's parent for all operations on the ScrolledWindow. To obtain the ID of the ScrolledWindow widget associated with the Text widget, use the Xt Intrinsics XtParent function. The name of the ScrolledWindow created by this function is formed by concatenating the letters SW onto the end of the name specified in the parameter list. The Text widget defaults to single-line text edit; therefore, no ScrollBars are displayed. The Text resource XmNeditMode must be set to XmMULTI_LINE_EDIT to display the ScrollBars. The results of placing a Text widget inside a ScrolledWindow when the Text's XmNeditMode is XmSINGLE_LINE_EDIT are undefined. All arguments to either the Text or the ScrolledWindow widget can be specified at creation time with this function. Changes to initial position and size are sent only to the ScrolledWindow widget. Other resources are sent to the Text or the ScrolledWindow widget as appro- priate. Note that the result of providing the XmNdestroyCallback resource in the creation arglist is unspecified. The application should use the XtAddCallback function to add callbacks to the appropriate widget (Text or ScrolledWindow) after creating it. This function forces the following initial values for ScrolledWindow resources: o XmNscrollingPolicy is set to XmAPPLICATION_DEFINED. o XmNvisualPolicy is set to XmVARIABLE. o XmNscrollBarDisplayPolicy is set to XmSTATIC. o XmNshadowThickness is set to 0 (zero). parent Specifies the parent widget ID name Specifies the name of the created widget arglist Specifies the argument list argcount Specifies the number of attribute/value pairs in the argument list (arglist) For a complete definition of Text and its associated resources, see XmText(3). RETURN
Returns the Text widget ID. RELATED
XmScrolledWindow(3) and XmText(3). XmCreateScrolledText(library call)
Man Page