Managing Items Interaction

• Apr 01, 2021
• 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 existing diagram items’ properties by accessing them using the DiagramControl.Items collection. Alternatively, use the DiagramControl.AddingNewItem event to modify the properties of an item that is about to be added to the diagram by the end-user.

DiagramShape

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

DiagramConnector

Action	Item’s Property	Diagram’s Property
Copying	DiagramItem.CanCopy	DiagramControl.AllowCopyItems
Deleting	DiagramItem.CanDelete	DiagramControl.AllowAddRemoveItems
Dragging the begin and end points	DiagramConnector.CanDragBeginPoint DiagramConnector.CanDragEndPoint	DiagramControl.AllowResizeItems DiagramControl.AllowAttachDetachConnectors
Dragging intermediate points	DiagramConnector.CanChangeRoute	DiagramControl.AllowChangeConnectorsRoute
Editing the text	DiagramItem.CanEdit	DiagramControl.AllowEditItems
Moving	DiagramItem.CanMove	DiagramControl.AllowMoveItems
Selecting	DiagramItem.CanSelect

DiagramImage

Action	Item’s Property	Diagram’s Property
Attaching connectors	DiagramItem.CanAttachConnectorBeginPoint DiagramItem.CanAttachConnectorEndPoint
Copying	DiagramItem.CanCopy	DiagramControl.AllowCopyItems
Deleting	DiagramItem.CanDelete	DiagramControl.AllowAddRemoveItems
Hiding subordinate items	DiagramItem.CanHideSubordinates
Moving	DiagramItem.CanMove	DiagramControl.AllowMoveItems
Moving with subordinate items	DiagramItem.MoveWithSubordinates	DiagramControl.AllowMoveItems
Placing in/out of a container	DiagramItem.CanChangeParent	DiagramControl.AllowMoveItems
Resizing	DiagramItem.CanResize	DiagramControl.AllowResizeItems
Rotating	DiagramItem.CanRotate	DiagramControl.AllowRotateItems
Selecting	DiagramItem.CanSelect
Snapping	DiagramItem.CanSnapToOtherItems DiagramItem.CanSnapToThisItem

DiagramContainer

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

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