[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Programmer's Reference


XmRenderTableGetRenditions

A convenience function that matches rendition tags

Format

#include <Xm/Xm.h>
XmRendition *XmRenderTableGetRenditions
XmRenderTable
tableXmStringTag *tagsCardinal
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).


[ Previous | Next | Contents | Glossary | Home | Search ]