*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> XmRenderTableAddRenditions (3)              


 XmRenderTableAddRenditions(library cXamlRle)nderTableAddRenditions(library call)

 NAME    [Toc]    [Back]
      XmRenderTableAddRenditions - Creates a new render table

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

 DESCRIPTION    [Toc]    [Back]
      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.

                Specifies an array of renditions to be added.

                Specifies the number of renditions from renditions to be

                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    [Toc]    [Back]
                          Completely replaces the old rendition with the new

                XmMERGE_OLD    [Toc]    [Back]
                          Replaces any unspecified values of the old
                          rendition with the corresponding values from the
                          new rendition.

                                    - 1 -       Formatted:  January 24, 2005

 XmRenderTableAddRenditions(library cXamlRle)nderTableAddRenditions(library call)

                XmMERGE_NEW    [Toc]    [Back]
                          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    [Toc]    [Back]
      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

 RELATED    [Toc]    [Back]
      XmRendition(3) and XmRenderTableFree(3).

                                    - 2 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
XmRenderTableCvtFromProp HP-UX A render table function that converts from a string representation to a render table
XmRenderTableCvtToProp HP-UX A render table function that converts a render table to a string representation
XmRenderTable HP-UX Data type for a render table
XmRenderTableFree HP-UX A render table function that recovers memory
XmRenderTableCopy HP-UX A render table function that copies renditions
glcrenderchar IRIX render a character
glcrenderstring IRIX render a string
ttsyncd HP-UX Daemon to maintain the nis+ password table in sync with the nis+ trusted table.
fmoutchar IRIX render a single glyph.
glcrendercountedstring IRIX render a string of a specified number of characters
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service