SplitterPane.Size Property

Gets or sets the pane’s size (height or width, depending on the orientation).

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v19.2.dll

Declaration

C#

[DefaultValue(typeof(Unit), "")]
public Unit Size { get; set; }

VB.NET

<DefaultValue(GetType(Unit), "")>
Public Property Size As Unit

Property Value

Type	Default	Description
Unit	String.Empty	A Unit object that is the pane’s size.

Remarks

The Size property specifies the height for panes which are stacked vertically within their container (a parent pane of a splitter control), and the width - for horizontally stacked panes. The stack orientation depends on the ASPxSplitter.Orientation property value.

Depending upon the measurement unit (pixels or percents) used to set the Size property of a pane, you can control how the pane will affect the splitter control’s layout, and its behavior in different collapse/expansion scenarios.

The Size property can be defined in any HTML-compatible size unit with the exception of the UnitType.Em and UnitType.Ex types. These two unit types are not supported, because they depend upon the element font, and can’t be processed correctly.

Note, that you cannot use this property to specify the pane’s size value if it is less than the ASPxSplitter.PaneMinSize property’s value or the SplitterPane.MinSize property’s value (if it is specified for the current pane).

Note

This property is not in effect if the SplitterPane.AutoHeight or SplitterPane.AutoWidth property is set to true.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the Size property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-print-the-aspxscheduler-using-a-report-preview-e1625/CS/SchedulerReportPreviewTest/Root.Master.cs#L7

protected void Page_Load(object sender, EventArgs e) {
    MainSplitter.GetPaneByName("HeaderPane").Size = ASPxWebControl.GlobalTheme == "Moderno" ? 101 : 87;
    MainSplitter.GetPaneByName("HeaderPane").MinSize = ASPxWebControl.GlobalTheme == "Moderno" ? 101 : 87;

VB.NET

how-to-print-the-aspxscheduler-using-a-report-preview-e1625/VB/SchedulerReportPreviewTest/Root.Master.vb#L9

Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
    MainSplitter.GetPaneByName("HeaderPane").Size = If(ASPxWebControl.GlobalTheme = "Moderno", 101, 87)
    MainSplitter.GetPaneByName("HeaderPane").MinSize = If(ASPxWebControl.GlobalTheme = "Moderno", 101, 87)