DiagramOptionsView.CanvasSizeMode Property
Gets or sets whether the canvas size is automatically expanded/shrunk to fit the current shapes layout.
Namespace: DevExpress.XtraDiagram.Options
Assembly: DevExpress.XtraDiagram.v24.1.dll
NuGet Package: DevExpress.Win.Diagram
Declaration
[DefaultValue(CanvasSizeMode.AutoSize)]
[DiagramCategory(DiagramCategory.Options)]
public virtual CanvasSizeMode CanvasSizeMode { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| CanvasSizeMode | AutoSize | A CanvasSizeMode enumeration value. |
Available values:
| Name | Description |
|---|---|
| None | The canvas size does not change on moving shapes outside of it. |
| AutoSize | The canvas is automatically resized to fit the current shapes layout. |
| Fill | The canvas fills the entire visible area. |
Property Paths
You can access this nested property as listed below:
| Object Type | Path to CanvasSizeMode |
|---|---|
| DiagramControl |
|
Remarks
If the CanvasSizeMode property is set to CanvasSizeMode.AutoSize, the canvas size is automatically expanded/shrunk to fit the current shape layout.
Initially, the canvas size equals the size of one page (the DiagramOptionsView.PageSize property). When a shape is moved beyond the current canvas borders, the canvas is automatically expanded horizontally (by the PageSize.Width value) or vertically (by the PageSize.Height value).