DiagramOptionsBehavior.RectangleTool Property

Specifies the tool that is used when the end-user selects the Rectangle tool in the Ribbon.

Namespace: DevExpress.XtraDiagram.Options

Assembly: DevExpress.XtraDiagram.v24.1.dll

NuGet Package: DevExpress.Win.Diagram

Declaration

C#

[Browsable(false)]
public virtual DiagramTool RectangleTool { get; set; }

VB.NET

<Browsable(False)>
Public Overridable Property RectangleTool As DiagramTool

Property Value

Type	Description
DiagramTool	A DiagramTool object that represents the rectangle tool.

Property Paths

You can access this nested property as listed below:

Object Type	Path to RectangleTool
DiagramControl	.OptionsBehavior .RectangleTool

Remarks

The Rectangle tool creates a rectangular shape.

To provide the end-user with a custom Rectangle tool available from the Ribbon, create a FactoryItemTool object and assign it to the RectangleTool property. See the example below.

C#

diagramControl1.OptionsBehavior.RectangleTool = new FactoryItemTool("CustomRect", () => "CustomRect",
    diagram => new DiagramShape() {
    Shape = BasicShapes.Rectangle,
    ConnectionPoints = new PointCollection(new List<PointFloat>() { new PointFloat(0.5F, 0.5F) })},
    BasicShapes.Rectangle.DefaultSize, BasicShapes.Rectangle.IsQuick);

VB.NET

diagramControl1.OptionsBehavior.RectangleTool = New FactoryItemTool("CustomRect", Function() "CustomRect",
    Function(diagram) New DiagramShape() With {.Shape = BasicShapes.Rectangle, .ConnectionPoints = New PointCollection(New List(Of PointFloat)() From {New PointFloat(0.5F, 0.5F)})},
    BasicShapes.Rectangle.DefaultSize, BasicShapes.Rectangle.IsQuick)