Managing Items Interaction

• Oct 24, 2018
• 2 minutes to read

The Diagram control provides a set of properties that allow you to restrict end-users from performing certain operations with diagram items.

You can modify the properties of existing diagram items by accessing them using the DiagramControl.Items collection. Alternatively, use the DiagramControl.ItemCreating event to modify the properties of an item that is about to be created.

Shapes and Images

Operation	Item’s Property	Diagram’s Property
Attaching connectors	DiagramItem.CanAttachConnectorBeginPoint DiagramItem.CanAttachConnectorEndPoint
Copying	DiagramItem.CanCopy	DiagramOptionsProtection.AllowCopyItems
Deleting	DiagramItem.CanDelete	DiagramOptionsProtection.AllowAddRemoveItems
Editing the text	DiagramItem.CanEdit	DiagramOptionsProtection.AllowEditItems
Hiding subordinate items	DiagramItem.CanHideSubordinates
Moving	DiagramItem.CanMove	DiagramOptionsProtection.AllowMoveItems
Moving with subordinate items	DiagramItem.MoveWithSubordinates	DiagramOptionsProtection.AllowMoveItems
Placing in/out of a container	DiagramItem.CanChangeParent	DiagramOptionsProtection.AllowMoveItems
Resizing	DiagramItem.CanResize	DiagramOptionsProtection.AllowResizeItems
Rotating	DiagramItem.CanRotate	DiagramOptionsProtection.AllowRotateItems
Selecting	DiagramItem.CanSelect
Snapping	DiagramItem.CanSnapToOtherItems DiagramItem.CanSnapToThisItem
Transforming	DiagramShape.CanChangeParameter	DiagramOptionsProtection.AllowChangeShapesParameter

Connectors

Operation	Item’s Property	Diagram’s Property
Copying	DiagramItem.CanCopy	DiagramOptionsProtection.AllowCopyItems
Deleting	DiagramItem.CanDelete	DiagramOptionsProtection.AllowAddRemoveItems
Dragging the begin and end points	DiagramConnector.CanDragBeginPoint DiagramConnector.CanDragEndPoint	DiagramOptionsProtection.AllowResizeItems DiagramOptionsProtection.AllowAttachDetachConnectors
Dragging intermediate points	DiagramConnector.CanChangeRoute	DiagramOptionsProtection.AllowChangeConnectorsRoute
Editing the text	DiagramItem.CanEdit	DiagramOptionsProtection.AllowEditItems
Moving	DiagramItem.CanMove	DiagramOptionsProtection.AllowMoveItems
Placing in/out of a container	DiagramItem.CanChangeParent	DiagramOptionsProtection.AllowMoveItems
Selecting	DiagramItem.CanSelect

Containers

Operation	Item’s Property	Diagram’s Property
Adding items to the container	DiagramContainer.CanAddItems
Attaching connectors	DiagramItem.CanAttachConnectorBeginPoint DiagramItem.CanAttachConnectorEndPoint
Copying	DiagramItem.CanCopy	DiagramOptionsProtection.AllowCopyItems
Deleting	DiagramItem.CanDelete	DiagramOptionsProtection.AllowAddRemoveItems
Editing the header text	DiagramItem.CanEdit	DiagramOptionsProtection.AllowEditItems
Hiding subordinate items	DiagramItem.CanHideSubordinates
Moving	DiagramItem.CanMove	DiagramOptionsProtection.AllowMoveItems
Moving with subordinate items	DiagramItem.MoveWithSubordinates	DiagramOptionsProtection.AllowMoveItems
Placing in/out of another container	DiagramItem.CanChangeParent	DiagramOptionsProtection.AllowMoveItems
Resizing	DiagramItem.CanResize	DiagramOptionsProtection.AllowResizeItems
Rotating	DiagramItem.CanRotate	DiagramOptionsProtection.AllowRotateItems
Selecting	DiagramItem.CanSelect
Snapping	DiagramItem.CanSnapToOtherItems

Use the following properties to restrict operations with child items of a DiagramContainer. These properties have a lower priority than corresponding properties of the child items.

• DiagramContainer.ItemsCanAttachConnectorBeginPoint
• DiagramContainer.ItemsCanAttachConnectorEndPoint
• DiagramContainer.ItemsCanChangeParent
• DiagramContainer.ItemsCanCopyWithoutParent
• DiagramContainer.ItemsCanDeleteWithoutParent
• DiagramContainer.ItemsCanEdit
• DiagramContainer.ItemsCanMove
• DiagramContainer.ItemsCanResize
• DiagramContainer.ItemsCanRotate
• DiagramContainer.ItemsCanSelect
• DiagramContainer.ItemsCanSnapToOtherItems
• DiagramContainer.ItemsCanSnapToThisItem