X Version 11 (Release 6.1)

XmuCvtStringToBitmap(X3xmu)

XmuCvtStringToBitmap -- convert string to bitmap

Synopsis

cc . . . -lXmu

#include <X11/X.h>

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

Arguments

args: Sole argument specifies the Screen on which to create the bitmap.
num_args: Must be the value 1.
fromVal: Specifies the string to convert.
toVal: Returns the converted value.

Description

The XmuCvtStringToBitmap function creates a bitmap (a Pixmap of depth one) suitable for window manager icons.

The string argument is the name of a file in standard bitmap file format. For the possible filename specifications, see XmuLocateBitmapFile(X3xmu). To use this converter, include the following in your widget's ClassInitialize procedure:

   static XtConvertArgRec screenConvertArg[] = {
       {XtBaseOffset,
       (XtPointer)XtOffset(Widget, core.screen),
       sizeof(Screen *)}
   };
   XtAddConverter(XtRString, XtRBitmap, XmuCvtStringToBitmap,
   	         screenConvertArg, XtNumber(screenConvertArg));

References

XmuCvtFunctionToCallback(X3xmu), XmuCvtStringToBackingStore(X3xmu), XmuCvtStringToShapeStyle(X3xmu), XmuReshapeWidget(X3xmu), XmuCvtStringToWidget(X3xmu)
Xlib - C Language X Interface