PEXChangeStructureRefs - Change Structure References (5.0)

Synopsis 

 
   void PEXChangeStructureRefs(
        Display *display,
        PEXStructure old_structure,
        PEXStructure new_structure
   )

Arguments

display
A pointer to a display structure returned by a successful XOpenDisplay call.

old_structure The resource identifier of the structure no longer to be referenced.

new_structure
The resource identifier of the structure now referenced.

Returns

None.

Description

Invoke PEXChangeStructureRefs to modify all structure referencing elements in all of the existing structures which reference the structure identified by old_structure. The references are modified to reference the structure identified by new_structure instead. Existing references to new_structure are not affected.

For PHIGS workstation resources, if new_structure is already posted, then its posting is not modified. On PHIGS workstation resources where old_structure is posted but new_structure is not, a posting is added for new_structure at the same priority as old_structure. old_structure is unposted on all PHIGS workstation resources where it is posted. Both structures must already exist as valid structure resources.

If new_structure does not exist, then this function issues an error and no changes are made to any references to old_structure, if they exist.

Errors

BadPEXStructure
A specified structure resource identifier is invalid.

See Also

For a list of all Structure functions and related topics, see Structures.