XmuCvtStringToColorCursor(X3xmu) X Version 11 (Release 6.1)
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
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.