This documentation is archived and is not being maintained.

TabControl.Multiline Property

Gets or sets a value indicating whether more than one row of tabs can be displayed.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public bool Multiline { get; set; }

Property Value

Type: System.Boolean
true if more than one row of tabs can be displayed; otherwise, false. The default is false.

If Multiline is false, only one row of tabs is displayed, even if all the tabs do not fit in the available space. In that case, however, arrows are displayed that enable the user to navigate to the undisplayed tabs.

If the Multiline property is changed to false while the Alignment property is set to Left or Right, the Alignment property is automatically reset to Top.

The following code example creates a TabControl with four TabPage objects. The Multiline property is set to true, which displays two rows of tabs instead of one.

Use the System.Drawing and System.Windows.Forms namespaces for this example.


using System.Drawing;
using System.Windows.Forms;

public class Form1 : Form
{
    private TabControl tabControl1;
    private TabPage tabPage1;
    private TabPage tabPage2;
    private TabPage tabPage3;
    private TabPage tabPage4;

    private void MyTabs()
    {
        this.tabControl1 = new TabControl();
        this.tabPage1 = new TabPage();
        this.tabPage2 = new TabPage();
        this.tabPage3 = new TabPage();
        this.tabPage4 = new TabPage();

        // Allows more than one row of tabs.
        this.tabControl1.Multiline = true;

        this.tabControl1.Padding = new Point(22, 5);
        this.tabControl1.Controls.AddRange(new Control[] {
            this.tabPage1,
            this.tabPage2,
            this.tabPage3,
            this.tabPage4});
        this.tabControl1.Location = new Point(35, 25);
        this.tabControl1.Size = new Size(220, 220);

        this.tabPage1.Text = "myTabPage1";
        this.tabPage2.Text = "myTabPage2";
        this.tabPage3.Text = "myTabPage3";
        this.tabPage4.Text = "myTabPage4";        

        this.Size = new Size(300, 300);
        this.Controls.AddRange(new Control[] {
            this.tabControl1});
    }

    public Form1()
    {
        MyTabs();
    }

    static void Main() 
    {
        Application.Run(new Form1());
    }
}


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: