NAME
XmRenderTableRemoveRenditions — A convenience function that removes
renditions
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(library call)