NAME

       XmStringPutRendition    —    A    convenience    function   that   places   renditions   around   strings
       "XmStringPutRendition"

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.

RELATED

       XmString(3).

                                                                                         XmStringPutRendition(3)