XmuCvtStringToCursor(Xmu)      6 January 1993      XmuCvtStringToCursor(Xmu)
                          X Version 11 (Release 5)


 Name

    XmuCvtStringToCursor - convert string to cursor

 Syntax


    cc  . . .  -lXmu


    #include <X11/Xmu/Converters.h>

    void XmuCvtStringToCursor(args, num_args, fromVal,toVal)
           XrmValuePtr args;
           Cardinal *num_args;
           XrmValuePtr fromVal;
           XrmValuePtr toVal;


 Arguments


    args      Specifies the required conversion argument, the screen.

    numargs  Specifies the number of required conversion arguments, which is
              1.

    fromVal   Specifies the string to convert.

    toVal     Returns the converted value.


 Description

    The XmuCvtStringToCursor function converts a string to a Cursor.  The
    string can either be a standard cursor name formed by removing the
    ``XC_'' prefix from any of the cursor defines listed on the XCre-
    ateFontCursor(XS), 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
    your widget's ClassInitialize procedure:

       static XtConvertArgRec screenConvertArg[] = {
         {XtBaseOffset,
         (XtPointer)XtOffsetOf(WidgetRec, core.screen),
         sizeof(Screen *)}
       };

       XtAddConverter(XtRString, XtRCursor, XmuCvtStringToCursor,
                         screenConvertArg, XtNumber(screenConvertArg));


 See also

    XCreateFontCursor(XS), XmuCvtFunctionToCallback(Xmu),
    XmuCvtStringToBackingStore(Xmu), XmuCvtStringToColorCursor(Xmu),
    XmuCvtStringToGravity(Xmu), XmuCvtStringToJustify(Xmu),
    XmuCvtStringToLong(Xmu), XmuCvtStringToOrientation(Xmu),
    XmuCvtStringToShapeStyle(Xmu), XmuCvtStringToWidget(Xmu),
    XmuNewCvtStringToWidget(Xmu), XmuReshapeWidget(Xmu)
    Xlib - C Language X Interface