NAME

       XmRenderTableAddRenditions — Creates a new render table "XmRenderTableAddRenditions"

SYNOPSIS

       #include <Xm/Xm.h>
       XmRenderTable XmRenderTableAddRenditions(
       XmRenderTable oldtable,
       XmRendition *renditions,
       Cardinal rendition_count,
       XmMergeMode merge_mode);

DESCRIPTION

       XmRenderTableAddRenditions is a function to create a new render table that includes the renditions listed
       in  oldtable,  if  there  is  one. This function also copies specified renditions (renditions) to the new
       render table. The first rendition_count renditions of the renditions array are added to the new table. If
       a rendition is tagged with a tag that matches a tag already in  oldtable,  then  the  existing  rendition
       using that tag is either modified or freed and replaced with the new rendition, depending on the value of
       merge_mode.  If  oldtable  is NULL, XmRenderTableAddRenditions creates a new render table containing only
       the specified renditions.

       This function deallocates the original render table after extracting the required information. It is  the
       responsibility   of  the  caller  to  free  the  renditions  of  the  renditions  array  by  calling  the
       XmRenditionFree function.

       oldtable  Specifies the render table to be added to.

       renditions
                 Specifies an array of renditions to be added.

       rendition_count
                 Specifies the number of renditions from renditions to be added.

       merge_mode
                 Specifies what to do if the XmNtag of a rendition matches that of one that  already  exists  in
                 oldtable. The possible values are as follows:

                 XmMERGE_REPLACE
                           Completely replaces the old rendition with the new one.

                 XmMERGE_OLD
                           Replaces  any  unspecified  values of the old rendition with the corresponding values
                           from the new rendition.

                 XmMERGE_NEW
                           Replaces the old rendition with the new rendition, replacing any  unspecified  values
                           of the new rendition with the corresponding values from the old rendition.

                 XmSKIP    Skips over the new rendition, leaving the old rendition intact.

RETURN

       If  renditions  is  NULL  or rendition_count is 0 (zero), this function returns oldtable.  Otherwise, the
       function returns a new XmRenderTable.  The function allocates space to hold this new render  table.   The
       application  is responsible for managing this allocated space.  The application can recover the allocated
       space by calling XmRenderTableFree.

RELATED

       XmRendition(3) and XmRenderTableFree(3).

                                                                                   XmRenderTableAddRenditions(3)