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