BuyLog In
WinForms Controls
V 20.1
20.1
19.2
19.1
18.2
18.1
17.2
All docs
Docs > Controls and Libraries > Diagrams > Examples > How to: Create Custom Diagram Containers and Register them in the Toolbox and Ribbon Gallery
All docs
V20.1
20.1
19.2
19.1
18.2
18.1
17.2
Full-text search
WinForms Controls
.NET Core Support
Prerequisites
What's Installed
Build an Application
Controls and Libraries
Forms and User Controls
Messages, Notifications, and Dialogs
Editors and Simple Controls
Ribbon, Bars and Menu
Application UI Manager
Docking Library
Data Grid
Vertical Grid
Property Grid
Pivot Grid
Tree List
Gantt Control
Chart Control
Diagrams
Getting Started
Diagram Control
End-User Interaction
Diagram Items
Automatic Layout
Data Binding Functionality
Themes and Styles
Printing and Exporting
Saving and Loading Diagrams
Examples
How to: Handle DiagramControl Events to Save Diagrams to a Database instead of a File System
How to: Create Custom Shapes with Connection Points
How to: Create Custom Shapes with Connection Points Using XAML
How to: Use Custom Graph Layout Algorithms to Arrange Shapes in DiagramControl
How to: Use the CustomDrawItem Event to Draw Custom Icons Inside Diagram Items
How to: Create a DiagramShape Descendant and Serialize Its Properties
How to: Create Custom Diagram Containers and Register them in the Toolbox and Ribbon Gallery
How to: Change the Set of Shapes Available In the Shapes Panel
How to: Customize Connection Points
How to: Create a Custom Shapes Panel
Gauges
Map Control
Scheduler
Spreadsheet
Rich Text Editor
Spell Checker
Form Layout Managers
Navigation Controls
Printing-Exporting
PDF Viewer
Reporting
Snap
TreeMap Control
Sunburst Control
Common Features
Get More Help
API Reference
Download CHM

How to: Create Custom Diagram Containers and Register them in the Toolbox and Ribbon Gallery

  • 4 minutes to read

In this example, we show how to create containers with custom headers and padding. DiagramControl supports a special language for defining containers. The root element that contains a container description is ContainerShapeTemplate. This element describes a container contour and may contain several segments:- Start. Specifies the start point- Line. Defines a line with start and end points- Arc. Defines an arc with start and end pointsTo define a container's header editor position, use the EditorBounds property. To specify a padding, set the ActualPadding property.To register custom containers in the ribbon gallery, use the DiagramContainerGalleryRegistrator.RegisterContainerShapes method.

NOTE

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-create-custom-diagram-containers-and-register-them-in-the-toolbox-and-ribbon-gallery-t466447

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using DevExpress.Diagram.Core;
using DevExpress.Diagram.Core.Shapes;
using System.Windows;
using System.IO;
using System.Reflection;

namespace XtraDiagram.CreateCustomContainers {
    public partial class Form1 : DevExpress.XtraBars.Ribbon.RibbonForm {
        const string MyContainersStencilName = "MyContainers";
        static readonly ContainerShapeDescription[] containerDescriptions;
        static Form1() {
            using(var stream = Assembly.GetExecutingAssembly().GetManifestResourceStream("XtraDiagram.CreateCustomContainers.CustomContainers.xml")) {
                containerDescriptions = ShapeDescriptions.LoadDescriptionsFromXml(stream).OfType<ContainerShapeDescription>().ToArray();
            }
            DiagramContainerGalleryRegistrator.RegisterContainerShapes(containerDescriptions);
        }
        public Form1() {
            InitializeComponent();
            var customContainersStencil = DiagramStencil.Create(MyContainersStencilName, "Custom Containers", containerDescriptions);
            diagramControl1.OptionsBehavior.Stencils = new DiagramStencilCollection(DiagramToolboxRegistrator.Stencils.Concat(new[] { customContainersStencil }));
            diagramControl1.SelectedStencils = new StencilCollection(MyContainersStencilName, BasicShapes.StencilId);
        }
        protected override void OnLoad(EventArgs e) {
            base.OnLoad(e);
            this.diagramControl1.InitializeRibbon(this.ribbonControl1);
        }
    }

}