Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmRenderTa...Renditions(3) Library Functions Manual XmRenderTa...Renditions(3)

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 renditions (renditions) to the new ren-
       der 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	rendi-
       tion, depending on the value of merge_mode. If oldtable is NULL,	XmRen-
       derTableAddRenditions  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 XmRendition-
       Free 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	rendi-
			   tion	 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	rendi-
			   tion	with the corresponding	values	from  the  old
			   rendition.

		 XmSKIP	   Skips  over the new rendition, leaving the old ren-
			   dition intact.

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

RELATED
       XmRendition(3) and XmRenderTableFree(3).

						    XmRenderTa...Renditions(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmRenderTableAddRenditions&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help