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)