XmRenderTableRemoveRenditiUNIX3SXmRenderTableRemoveRenditions(3X)
NAME
XmRenderTableRemoveRenditions - A convenience function that
removes renditions
SYNOPSIS
#include <Xm/Xm.h>
XmRenderTable XmRenderTableRemoveRenditions(
XmRenderTable oldtable,
XmStringTag *tags,
int tag_count);
VERSION
This page documents Motif 2.1.
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).
Page 1 (printed 7/20/06)