1XmRenderTableAddRenditions(library callX)mRenderTableAddRenditions(library call)
2
3
4

NAME

6       XmRenderTableAddRenditions — Creates a new render table
7

SYNOPSIS

9       #include <Xm/Xm.h>
10       XmRenderTable XmRenderTableAddRenditions(
11       XmRenderTable oldtable,
12       XmRendition *renditions,
13       Cardinal rendition_count,
14       XmMergeMode merge_mode);
15

DESCRIPTION

17       XmRenderTableAddRenditions  is  a function to create a new render table
18       that includes the renditions listed in oldtable, if there is one.  This
19       function  also copies specified renditions (renditions) to the new ren‐
20       der table. The first rendition_count renditions of the renditions array
21       are  added  to  the new table. If a rendition is tagged with a tag that
22       matches a tag already in oldtable, then the  existing  rendition  using
23       that  tag  is either modified or freed and replaced with the new rendi‐
24       tion, depending on the value of merge_mode. If oldtable is NULL, XmRen‐
25       derTableAddRenditions  creates  a  new render table containing only the
26       specified renditions.
27
28       This function deallocates the original render  table  after  extracting
29       the  required  information.  It  is the responsibility of the caller to
30       free the renditions of the renditions array by calling the XmRendition‐
31       Free function.
32
33       oldtable  Specifies the render table to be added to.
34
35       renditions
36                 Specifies an array of renditions to be added.
37
38       rendition_count
39                 Specifies  the  number  of  renditions  from renditions to be
40                 added.
41
42       merge_mode
43                 Specifies what to do if the XmNtag  of  a  rendition  matches
44                 that  of  one  that  already exists in oldtable. The possible
45                 values are as follows:
46
47                 XmMERGE_REPLACE
48                           Completely replaces the old rendition with the  new
49                           one.
50
51                 XmMERGE_OLD
52                           Replaces  any  unspecified values of the old rendi‐
53                           tion with the corresponding  values  from  the  new
54                           rendition.
55
56                 XmMERGE_NEW
57                           Replaces  the old rendition with the new rendition,
58                           replacing any unspecified values of the new  rendi‐
59                           tion  with  the  corresponding  values from the old
60                           rendition.
61
62                 XmSKIP    Skips over the new rendition, leaving the old  ren‐
63                           dition intact.
64

RETURN

66       If  renditions  is  NULL  or rendition_count is 0 (zero), this function
67       returns oldtable.  Otherwise, the function returns a new XmRenderTable.
68       The function allocates space to hold this new render table.  The appli‐
69       cation is responsible for managing this allocated space.  The  applica‐
70       tion can recover the allocated space by calling XmRenderTableFree.
71
73       XmRendition(3) and XmRenderTableFree(3).
74
75
76
77                                      XmRenderTableAddRenditions(library call)
Impressum