XmStringPutRendition(3X)

     NAME
          XmStringPutRendition - A convenience function that places
          renditions around strings

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

     VERSION
          This page documents Motif 2.1.

     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_ENDcomponent 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).