Skip to main content

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
.OptionsView .CanvasSizeMode

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).

See Also