XmRenderTableRemoveRenditions(3)

XmRenderTableRemoveRenditions — A convenience function that removes renditions "XmRenderTableRemoveRenditions"

Section 3 libmotif-dev bookworm source

Description

XmRenderTableRemoveRenditions

NAME

XmRenderTableRemoveRenditions — A convenience function that removes renditions "XmRenderTableRemoveRenditions"

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.

XmRendition(3) and XmRenderTableFree(3).