X Version 11 (Release 6.1)

XmuCvtStringToColorCursor(X3xmu)

XmuCvtStringToColorCursor -- convert string to color cursor

Synopsis

cc . . . -lXmu

#include <X11/Xmu/Converters.h>

Boolean XmuCvtStringToColorCursor(dpy, args, num_args, fromVal, toVal, data)
	Display *dpy
	XrmValuePtr args;
	Cardinal *num_args;
	XrmValuePtr fromVal;
	XrmValuePtr toVal;
	XtPointer *data;

Arguments

dpy: Specifies the display to use for conversion warnings.
args: Specifies the required conversion arguments.
num_args: Specifies the number of required conversion arguments, which is 4.
fromVal: Specifies the string to convert.
toVal: Returns the converted value.
data: This argument is ignored.

Description

This function converts a string to a Cursor with the foreground and background pixels specified by the conversion arguments. The string can either be a standard cursor name formed by removing the ``XC_'' prefix from any of the cursor defines listed on the XCreateFontCursor(X3xlib) manual page of the Xlib Manual, a font name and glyph index in decimal of the form ``FONT fontname index [[font] index]'', or a bitmap filename acceptable to XmuLocateBitmapFile.

To use this converter, include the following in the widget ClassInitialize procedure:

static XtConvertArgRec colorCursorConvertArgs[] = {
  {XtWidgetBaseOffset, (XtPointer) XtOffsetOf(WidgetRec, core.screen),
  sizeof(Screen *)},
  {XtResourceString, (XtPointer) XtNpointerColor, sizeof(Pixel)},
  {XtResourceString, (XtPointer) XtNpointerColorBackground, sizeof(Pixel
)},

  {XtWidgetBaseOffset, (XtPointer) XtOffsetOf(WidgetRec, core.colormap),
  sizeof(Colormap)}
};

XtSetTypeConverter(XtRString, XtRColorCursor, XmuCvtStringToColorCursor,
                   colorCursorConvertArgs, XtNumber(colorCursorConvertArgs),
                   XtCacheByDisplay, NULL);

The widget must recognize XtNpointerColor and XtNpointerColorBackground as resources, or specify other appropriate foreground and background resources. The widget's Realize and SetValues methods must cause the converter to be invoked with the appropriate arguments when one of the foreground, background, or cursor resources has changed, or when the window is created, and must assign the cursor to the window of the widget.

References

XmuCvtFunctionToCallback(X3xmu), XmuCvtStringToBackingStore(X3xmu), XmuCvtStringToCursor(X3xmu), XmuCvtStringToGravity(X3xmu), XmuCvtStringToJustify(X3xmu), XmuCvtStringToLong(X3xmu), XmuCvtStringToOrientation(X3xmu), XmuCvtStringToShapeStyle(X3xmu), XmuNewCvtStringToWidget(X3xmu), XmuReshapeWidget(X3xmu), XmuCvtStringToWidget(X3xmu)
Xlib - C Language X Interface