XmStringPutRendition(3X)



     XmStringPutRendition(3X)  UNIX System V  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
          XmSTRINGCOMPONENTRENDITIONBEGIN and
          XmSTRINGCOMPONENTRENDITIONEND 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
                    XmSTRINGCOMPONENTRENDITIONBEGIN component which
                    will begin the returned string and in an
                    XmSTRINGCOMPONENTRENDITIONENDcomponent 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).



















     Page 1                                          (printed 1/22/99)
Museum
