XtraTabControl.MultiLine Property

Gets or sets whether more than one row of tab headers can be displayed.

Namespace: DevExpress.XtraTab

Assembly: DevExpress.XtraEditors.v21.2.dll

NuGet Packages: DevExpress.Win.Design, DevExpress.Win.Navigation

Declaration

C#

[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Behavior")]
public virtual DefaultBoolean MultiLine { get; set; }

VB.NET

<DXCategory("Behavior")>
<DefaultValue(DefaultBoolean.Default)>
Public Overridable Property MultiLine As DefaultBoolean

Property Value

Type	Default	Description
DefaultBoolean	Default	A DefaultBoolean value which specifies whether more than one row of tab headers can be displayed.

Available values:

Name	Description
True	true. DefaultBoolean.True has a constant value of 0, while the standard true value corresponds to a value of 1. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
False	false. DefaultBoolean.False has a constant value of 1, while the standard false value corresponds to a value of 0. In Visual Basic, do not use implicit conversion of Boolean values to DefaultBoolean, and vice versa, as the conversion may produce incorrect results.
Default	The default behavior determined by the control’s logic.

Remarks

If the MultiLine property is set to ‘False’ or ‘Default’, only one row of tabs is displayed - even if all the page headers don’t fit in the available space. In this case navigation buttons are displayed which allow end-users to scroll the tab pages.

Otherwise, if this property is set to ‘True’ multiple rows of tab headers are displayed if the page headers don’t fit the available space. In this case the XtraTabControl.HeaderAutoFill property can be set to ‘True’ so that the tab headers are automatically stretched to fill the empty space in a tab row as shown in the image below: