Name

PEXChangeStructureRefs - Change Structure References

Synopsis

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

Arguments

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

old_structureThe resource identifier of the structure no longer to be referenced. 

new_structure
The resource identifier of the structure now referenced.

Returns

None

Description

This function changes "execute structure" elements in the server that reference the specified old structure into "execute structure" elements which reference the specified new structure.  Both structures must already exist as valid structure resources. 

Any references to the new structure that existed before this request are not affected.  If there were references to the old structure and the new structure does not exist, an error is returned and no action is taken. 

On all PHIGS workstation resources where the new structure is not already posted and the old structure is posted, the new structure is posted with the same priority as the old structure and the old structure is unposted. 

Data Structures

typedef XID             PEXStructure;

Errors

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

PEXCreateStructure PEXGetStructureInfo, PEXGetStructuresInNetwork,
PEXGetAncestors, PEXGetDescendants