NAME

       XmRenderTableGetRenditions   —   A   convenience  function  that  matches  rendition  tags
       "XmRenderTableGetRenditions"

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(3)