GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XMRENDERTABLEADDRENDITIONS (3)

NAME

XmRenderTableAddRenditions — Creates a new render table

CONTENTS

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).

Search for    or go to Top of page |  Section 3 |  Main Index


XMRENDERTABLEADDRENDITIONS (3) -->

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.