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
[Browsable(true)]
[DefaultValue(1)]
[XtraSerializableProperty]
public virtual int ColumnSpan { get; set; }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 |
|
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.