XmRenderTableGetRenditionsUNIX SystXmRenderTableGetRenditions(3X)
NAME
XmRenderTableGetRenditions - A convenience function that
matches rendition tags
SYNOPSIS
#include <Xm/Xm.h>
XmRendition *XmRenderTableGetRenditions(
XmRenderTable table,
XmStringTag *tags,
Cardinal tagcount);
VERSION
This page documents Motif 2.1.
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).
Page 1 (printed 1/22/99)