XmRenderTableGetRenditions - Man Page

#include <Xm/Xm​.h>
XmRendition *XmRenderTableGetRenditions(
XmRenderTable table,
XmStringTag *tags,
Cardinal tag_count);

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​.

Returns NULL if there is no match; otherwise, this function returns an array of new XmRenditions​.

XmRenderTableGetRendition(3), XmRenderTableGetTags(3), and XmRendition(3)​.

XmRenderTable(3), XmRenderTableGetRendition(3).