[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
    Getting Started
   [Expand]Diagram Control
   [Expand]End-User Interaction
   [Collapse]Diagram Items
     Default Shapes
     SVG Shapes
     Creating Shapes and Containers Using Shape Templates
     Customizing the Appearance of Items
     Managing Items Interaction
   [Expand]Automatic Layout
   [Expand]Data Binding Functionality
    Themes and Styles
    Printing and Exporting
    Saving and Loading Diagrams
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)


Shapes are basic elements of the DiagramControl. You or your end-user can add shapes to the diagram canvas by dragging them from the Shapes Panel.

Shapes are encapsulated by DiagramShape class objects. The size and position of shapes can be specified with the Width, Height, and Position properties. To specify the shape kind in code, use the DiagramShape.Shape property.

Expanded Shape operations


Click a shape to select it. To select multiple shapes, hold the CTRL or SHIFT key and click each shape you want to select. Alternatively, click on the canvas and drag to create a selection rectangle around the shapes you want to select. To select all shapes in the page, press CTRL+A key combination. The selected shapes are outlined by a rectangle with selection handles. To deselect a shape, hold the CTRL or SHIFT key and click it. To deselect all shapes, press the ESC key.


To move the selected shape/shapes, drag it using the mouse or press arrow keys.


To resize the selected shape or multiple shapes, drag one of the selection handles.


To copy the selected shape or multiple shapes, drag it while holding the CTRL key or press the CTRL+C key combination to copy the selection to clipboard and then press the CTRL+V key combination to paste the clipboard content to the canvas.


To rotate the selected shape or multiple shapes, drag the rotation handle.


Certain shapes display yellow handles when selected. These shapes can be transformed by dragging these handles.

Editing text

Double-click a shape to enter the text editing mode. To accept changes, press the ESC key or click anywhere on the canvas.

Expanding/collapsing subordinate items

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

Expanded See Also

Is this topic helpful?​​​​​​​