Unix/Linux Go Back    


CentOS 7.0 - man page for xmrendertableaddrenditions (centos section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


XmRenderTableAddRenditions(library call)		 XmRenderTableAddRenditions(library call)

NAME
       XmRenderTableAddRenditions -- Creates a new render table

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 rendi-
       tions  (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 informa-
       tion.  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 corre-
			   sponding 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(library call)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 04:06 PM.