XmStringPutRendition

Section: Misc. Reference Manual Pages (library call) Local index Up

NAME

XmStringPutRendition --- A convenience function that places renditions around strings

SYNOPSIS

#include <Xm/Xm.h>
XmString XmStringPutRendition(
XmString string,
XmStringTag rendition);

DESCRIPTION

XmStringPutRendition places matching Xm_STRING_COMPONENT_RENDITION_BEGIN and XmSTRING_COMPONENT_RENDITION_END components containing rendition around string. The original string is preserved.

string: Specifies the compound string to which begin and end rendition components should be added.
rendition: Specifies the rendition tag to be used in an XmSTRING_COMPONENT_RENDITION_BEGIN component which will begin the returned string and in an XmSTRING_COMPONENT_RENDITION_END component which will end it.

RETURN

Returns a new compound string. The function allocates space to hold this returned compound string. When the application no longer needs the returned compound string, the application should call XmStringFree.

XmString(3).