OptionsTableLayoutItem.ColumnSpan Property

Gets or sets the number of columns spanned by the current layout item within the table layout.

Namespace: DevExpress.XtraLayout

Assembly: DevExpress.XtraLayout.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[Browsable(true)]
[DefaultValue(1)]
[XtraSerializableProperty]
public virtual int ColumnSpan { get; set; }

VB.NET

<Browsable(True)>
<DefaultValue(1)>
<XtraSerializableProperty>
Public Overridable Property ColumnSpan As Integer

Property Value

Type	Default	Description
Int32	1	A positive integer value that specifies the number of columns spanned by the layout item.

Property Paths

You can access this nested property as listed below:

Object Type	Path to ColumnSpan
BaseLayoutItem	.OptionsTableLayoutItem .ColumnSpan

Remarks

Layout items are positioned within the table layout according to their OptionsTableLayoutItem.RowIndex and OptionsTableLayoutItem.ColumnIndex properties. The OptionsTableLayoutItem.RowSpan and ColumnSpan settings define the number of columns and rows occupied by a specific layout item.

The following image demonstrates the table layout that consists of five items arranged in three columns and three rows.

Note

If you specify the same target table cells for two or more layout items, these items will overlap.

You cannot set the ColumnSpan property to a value that is less than 1 or exceeds the number of columns available for item arrangement.