XmRenderTableRemoveRenditions(libXrmaRreyndcearlTla)bleRemoveRenditions(library call)
NAME [Toc] [Back]
XmRenderTableRemoveRenditions - A convenience function that removes
renditions
SYNOPSIS [Toc] [Back]
#include <Xm/Xm.h>
XmRenderTable XmRenderTableRemoveRenditions(
XmRenderTable oldtable,
XmStringTag *tags,
int tag_count);
DESCRIPTION [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
XmRendition(3) and XmRenderTableFree(3).
- 1 - Formatted: January 24, 2005 [ Back ] |
