NAME
XmRenderTableGetRenditions — A convenience function that matches
rendition tags
SYNOPSIS
#include <Xm/Xm.h>
XmRendition *XmRenderTableGetRenditions(
XmRenderTable table,
XmStringTag *tags,
Cardinal tag_count);
DESCRIPTION
XmRenderTableGetRenditions searches table and returns an array of
copies of the renditions whose XmNtag resources match a tag in tags.
If no renditions match, then NULL is returned. The size of the returned
array is tag_count. The XmNtag resource of each rendition will match
the corresponding tag in tags. If no match is found for a particular
tag, the corresponding slot in the return value will be NULL.
It is the responsibility of the caller to call the XmRenditionFree
function to free the new renditions, and the XtFree function to free
the array.
table Specifies the table containing renditions to be searched.
tags Specifies the tags to search for.
tag_count Specifies the number of tags in tags.
RETURN
Returns NULL if there is no match; otherwise, this function returns an
array of new XmRenditions.
RELATED
XmRenderTableGetRendition(3), XmRenderTableGetTags(3), and
XmRendition(3).
XmRenderTableGetRenditions(library call)