XmRenderTableRemoveRenditions(library call)

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)