Structure Permissions


See also: Changing Structure Permissions. For a list of all Structure functions and related topics, see Structures.

A structure's permission indicates which operations you are allowed to perform on a structure. Structure Permissions and Operations table lists the structure requests allowed for each permission. You may perform all rendering and picking requests on structures of any permission with the following exception:

A structure's permission defaults to StructureReadWrite when you create it. Use the PEXSetStructurePermission function to change the permission of the structure.

Structure Permissions and Operations
-----------------------------------------------------------------------------
Permission               Allowed Structure Operations
-----------------------------------------------------------------------------
StructureReadWrite       All.
 
StructureWriteOnly       All but PEXFetchElements.
 
StructureLocked          PEXChangeStructureReferences,
                         PEXDestroyStructures,
                         PEXGetAncestors,
                         PEXGetDescendants,
                         PEXGetStructureInfo,
                         PEXGetStructuresInNetwork.
 
-----------------------------------------------------------------------------

When a structure's permission is StructureWriteOnly you cannot copy its elements to a structure which has a permission of StructureReadWrite. You cannot edit, inquire, or copy elements from a structure that has its permission set to StructureLocked.

If you lock a structure that contains Execute Structure, Conditional Execute Structure, Include Structure, or Conditional Include Structure output commands, you do not modify the permissions of the referenced structures. Locked structures may include references to other structures. These references are updated by the implementation in response to PEXChangeStructureReferences requests or the deletion of the referenced structures as if the structure were not locked.

Changing Structure Permissions

See also: Structure Permissions. For a list of all Structure functions and related topics, see Structures.

You can change the permission of a newly created structure, or a structure whose permission has not yet been modified, to the permissions StructureWriteOnly or StructureLocked. If you change a structure's permission to StructureWriteOnly, you can only change it to the permission StructureLocked. If you change a structure's permission to StructureLocked then you can no longer alter that structure's permission. Note that it is an error to attempt to change the permission of a structure to the structure's current permission.

Allowed Structure Permission Changes
------------------------------------------
Current Permission  WriteOnly       Locked
------------------------------------------
ReadWrite           OK              OK
WriteOnly           Error           OK
Locked              Error           Error
------------------------------------------