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

FreeBSD Manual Pages

  
 
  

home | help
XmRenderTableAddRenditions(Library Functions ManuXmRenderTableAddRenditions(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).

						 XmRenderTableAddRenditions(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN | RELATED

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

home | help