DiagramSettings.SettingsContextToolbox Property

Provides access to the context toolbox’s settings.

Namespace: DevExpress.Web.Mvc

Assembly: DevExpress.Web.Mvc5.v24.2.dll

Declaration

C#

public MVCxDiagramContextToolboxSettings SettingsContextToolbox { get; }

VB.NET

Public ReadOnly Property SettingsContextToolbox As MVCxDiagramContextToolboxSettings

Property Value

Type	Description
MVCxDiagramContextToolboxSettings	An object that contains the context toolbox’s settings.

Remarks

The context toolbox appears when you draw a connector from a shape and release it without it being connected to another shape. The toolbox allows users to create a shape at the end of the connector.

The context toolbox displays the category of the shape from which a user draws a connector, by default. Use the following properties to explicitly specify the shapes that the context toolbox displays.

• Category - allows you to display every shape of a default shape category.

• CustomCategoryName - allows you to display every shape of a custom shape category.

• Shapes - allows you to display a custom collection of default and custom shapes.

Default Category

@Html.DevExpress().Diagram(settings => {
  settings.Name = "Diagram";
  settings.SettingsContextToolbox.Category = DiagramShapeCategory.General;
}).GetHtml()

Custom Category

@Html.DevExpress().Diagram(settings => {
  settings.Name = "Diagram";
  settings.SettingsContextToolbox.CustomCategoryName = "hardware";

  settings.CustomShapes.Add(c => {
    c.Type = "pc";
    c.Category = "hardware";
    ...
}).GetHtml()

List of Shapes

@Html.DevExpress().Diagram(settings => {
  settings.Name = "Diagram";
  settings.SettingsContextToolbox.Shapes.Add(s => { s.CustomShapeType = "pc"; });
  settings.SettingsContextToolbox.Shapes.Add(s => { s.CustomShapeType = "laptop"; });
  settings.SettingsContextToolbox.Shapes.Add(s => { s.CustomShapeType = "phone"; });
  settings.SettingsContextToolbox.Shapes.Add(s => { s.CustomShapeType = "mobile"; });
  settings.SettingsContextToolbox.Shapes.Add(s => { s.Type = DiagramShapeType.VerticalContainer; });
  settings.SettingsContextToolbox.Shapes.Add(s => { s.Type = DiagramShapeType.HorizontalContainer; });

  settings.CustomShapes.Add(c => {
    c.Type = "pc";
    c.Category = "hardware";
    ...
}).GetHtml()