XmRenderTableRemoveRenditions()



     XmRenderTableRemoveRenditiUNIX3SXmRenderTableRemoveRenditions(3X)



     NAME
          XmRenderTableRemoveRenditions - A convenience function that
          removes renditions

     SYNOPSIS
          #include <Xm/Xm.h>
          XmRenderTable XmRenderTableRemoveRenditions(
          XmRenderTable oldtable,
          XmStringTag *tags,
          int tagcount);

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          XmRenderTableRemoveRenditions removes from oldtable the
          renditions whose tags match the tags specified in tags, then
          places the remaining renditions in a newly created render
          table.

          oldtable  Specifies the render table from which renditions
                    are to be removed.  This function deallocates the
                    original render table and the matching renditions
                    after extracting the required information.

          tags      Specifies an array of tags, whose corresponding
                    renditions are to be removed from oldtable.

          tag_count Specifies the number of tags in tags.

     RETURN
          If oldtable or tags is NULL, or tag_count is 0 (zero), or no
          renditions are removed from oldtable, this function returns
          oldtable. Otherwise, it returns a newly allocated
          XmRenderTable.  The application is responsible for managing
          this allocated render table.  The application can recover
          this allocated space by calling XmRenderTableFree.

     RELATED
          XmRendition(3) and XmRenderTableFree(3).















     Page 1                                          (printed 1/22/99)
Museum
