XmuCvtStringToWidget(Xmu) 6 January 1993 XmuCvtStringToWidget(Xmu)
X Version 11 (Release 5)
Name
XmuCvtStringToWidget - convert string to immediate child widget
Syntax
cc . . . -lXmu
#include <X11/Xmu/Converters.h>
void XmuCvtStringToWidget(args, num_args, fromVal,toVal)
XrmValuePtr args;
Cardinal *num_args;
XrmValuePtr fromVal;
XrmValuePtr toVal;
Arguments
args This sole argument is the parent Widget.
numargs This argument must be 1.
fromVal Specifies the string to convert.
toVal Returns the converted value.
Description
The XmuCvtStringToWidget function converts a string to an immediate child
widget of the parent widget passed as an argument.
Note that this converter only works for child widgets that have already
been created; there is no lazy evaluation. The string is first compared
against the names of the normal and popup children, and if a match is
found the corresponding child is returned. If no match is found, the
string is compared against the classes of the normal and popup children,
and if a match is found the corresponding child is returned. The case of
the string is significant. To use this converter, include the following
in your widget's ClassInitialize procedure:
static XtConvertArgRec parentCvtArg[] = {
{XtBaseOffset,
(XtPointer)XtOffset(Widget, core.parent),
sizeof(Widget)},
};
XtAddConverter(XtRString, XtRWidget, XmuCvtStringToWidget,
parentCvtArg, XtNumber(parentCvtArg));
See also
XmuCvtFunctionToCallback(Xmu), XmuCvtStringToBackingStore(Xmu),
XmuCvtStringToShapeStyle(Xmu), XmuReshapeWidget(Xmu)
Xlib - C Language X Interface