NAME

       XmRenderTableRemoveRenditions     —     A     convenience     function     that     removes    renditions
       "XmRenderTableRemoveRenditions"

SYNOPSIS

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

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

                                                                                XmRenderTableRemoveRenditions(3)