End-User Interaction

  • 4 minutes to read

This document describes end-user operations available in the Diagram Control and Diagram Designer.

TIP

Set the DiagramOptionsProtection.IsReadOnly property to true to restrict end-user operations. Setting the desired DiagramOptionsProtection options overrides the IsReadOnly property.

Basic Actions

These operations available both in the Diagram Control and Diagram Designer.

Select items on the canvas

Select the Pointer tool in the Tools group of the Ribbon and click an item to select it. To select multiple items, hold SHIFT and click items or drag to draw a marquee over the items you want to select.

Corresponding property: DiagramOptionsBehavior.SelectionMode

Copy

To copy the selected items, press CTRL+C. To paste the clipboard content to the canvas, press the CTRL+V key combination. You can also hold down the CTRL key and drag the selected items.

Corresponding property: DiagramOptionsProtection.AllowCopyItems

Resize an item

Select the item and drag a selection handle.

Corresponding property: DiagramOptionsProtection.AllowResizeItems

Move an item

Select the item and drag it or press the arrow keys.

Corresponding property: DiagramOptionsProtection.AllowMoveItems

Rotate an item

diagram_shape_rotation

Select the item and drag the rotation handle with the mouse.

Corresponding property: DiagramOptionsProtection.AllowRotateItems

Transform a shape

Certain shapes display yellow handles when selected. Drag the handle to transform the shape.

diagram_shape_transform

Corresponding property: DiagramOptionsProtection.AllowChangeShapesParameter

Initiate text editing

Double-click an item or right-click it and select the Edit text menu item. To accept changes, press the ESC key or click anywhere on the canvas.

Corresponding property: DiagramOptionsProtection.AllowEditItems

Perform undo/redo operations

Press the CTRL+Z / CTRL+Y key combination.

Corresponding property: DiagramOptionsProtection.AllowUndoRedo

Change the current zoom

Hold the CTRL button and rotate the mouse wheel.

Corresponding property: DiagramOptionsProtection.AllowZoom

Expand/collapse subordinate items

Click the expand-collapse button below a shape to show or hide the subordinate items.

Expand subordinates

Diagram Designer Actions

These operations are only available in the Diagram Designer.

Add a shape to the canvas

Drag the shape from the Shapes Panel or select a drawing tool (Rectangle, Ellipse, Right Triangle, Hexagon) in the Tools group of the Ribbon and drag on the canvas to draw the corresponding shape.

Corresponding property: DiagramOptionsProtection.AllowAddRemoveItems

Add a container to the canvas

Select the Container ribbon item on the Insert ribbon page.

diagram adding container

Corresponding property: DiagramOptionsProtection.AllowAddRemoveItems

Resize an item

Select the item and change the Size property in the Properties Panel.

Setting the DiagramOptionsProtection.AllowResizeItems property to false does not restrict this operation.

Move an item

Select the item and change the Position property in the Properties panel.

Setting the DiagramOptionsProtection.AllowMoveItems property to false does not restrict this operation.

Rotate an item

Select the item and change the Angle property in the Properties panel.

Setting the DiagramOptionsProtection.AllowRotateItems property to false does not restrict this operation.

Change the item's text

Select the Text tool in the Tools group of the Ribbon and click an item.

Select an item and change the Text property within the Properties panel. The AllowEditItems property does not affect this operation.

Change the text within an item

Select the item and change the Text property within the Properties panel.

Setting the DiagramOptionsProtection.AllowEditItems property to false does not restrict this operation.

Format the text within an item

Select the item and use the Ribbon's Font and Paragraph groups to change the font family, color and size, make text bold, italic, underline or strikethrough and apply horizontal and vertical alignment.

Corresponding properties:

Add a connector

Select the Connector tool in the Tools group of the Ribbon and drag on the canvas. For a detailed description of connecting shapes, see Connectors.

Corresponding property: DiagramOptionsProtection.AllowAddRemoveItems

Add text

Select the Text tool in the Tools group of the Ribbon and drag on the canvas to add a rectangular shape with transparent background and outline. If you don't type any text, the shape is automatically deleted to avoid clutter.

Perform undo/redo operations

Click the corresponding button Diagram_undoredo at the top of the Ribbon.

Corresponding property: DiagramOptionsProtection.AllowUndoRedo

Change the current zoom

Use the zoom trackbar in the Bottom Panel.

Corresponding property: DiagramOptionsProtection.AllowZoom

Apply a theme to the diagram

Select the desired theme it in the Ribbon's Themes group on the Design page.

Corresponding property: DiagramOptionsProtection.AllowChangeTheme

Change the color of an item

Select the item and pick the desired color using the Background and Stroke color pickers in the Ribbon's Shape Styles group on the Home page or choose a predefined style. You can also change the BackgroundColor, ForegroundColor and Stroke properties in the Properties panel.

Corresponding properties:

See Also