xmrendertableremoverenditions(3) [centos man page]

XmRenderTableRemoveRenditions(library call)							       XmRenderTableRemoveRenditions(library call)

NAME

       XmRenderTableRemoveRenditions -- A convenience function that removes renditions

SYNOPSIS

       #include <Xm/Xm.h>
       XmRenderTable XmRenderTableRemoveRenditions(
       XmRenderTable oldtable,
       XmStringTag *tags,
       int tag_count);

DESCRIPTION

       XmRenderTableRemoveRenditions  removes  from oldtable the renditions whose tags match the tags specified in tags, then places the remaining
       renditions in a newly created render table.

       oldtable  Specifies the render table from which renditions are to be removed.  This function deallocates the original render table and  the
		 matching renditions after extracting the required information.

       tags	 Specifies an array of tags, whose corresponding renditions are to be removed from oldtable.

       tag_count Specifies the number of tags in tags.

RETURN

       If  oldtable  or tags is NULL, or tag_count is 0 (zero), or no renditions are removed from oldtable, this function returns oldtable. Other-
       wise, it returns a newly allocated XmRenderTable.  The application is responsible for managing this allocated render table.   The  applica-
       tion can recover this allocated space by calling XmRenderTableFree.

RELATED

       XmRendition(3) and XmRenderTableFree(3).

												       XmRenderTableRemoveRenditions(library call)

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 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 cor-
			   responding 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 appli-
       cation can recover the allocated space by calling XmRenderTableFree.

RELATED

       XmRendition(3) and XmRenderTableFree(3).

													  XmRenderTableAddRenditions(library call)