Skip to main content
.NET Framework Class Library
TabControl..::.SizeMode Property

Gets or sets the way that the control's tabs are sized.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Syntax
Public Property SizeMode As TabSizeMode
public TabSizeMode SizeMode { get; set; }
public:
property TabSizeMode SizeMode {
	TabSizeMode get ();
	void set (TabSizeMode value);
}
member SizeMode : TabSizeMode with get, set

Property Value

Type: System.Windows.Forms..::.TabSizeMode
One of the TabSizeMode values. The default is Normal.
Exceptions
ExceptionCondition
InvalidEnumArgumentException

The property value is not a valid TabSizeMode value.

Examples

The following code example creates a TabControl with five TabPage. This example sets the SizeMode property to FillToRight, which sizes the tabs so that each row fills the entire width of tabControl1.

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


Imports System.Drawing
Imports System.Windows.Forms

Public Class Form1
    Inherits Form
    Private tabControl1 As TabControl

    Public Sub New()
        Me.tabControl1 = New TabControl()
        Dim tabPage1 As New TabPage()
        Dim tabPage2 As New TabPage()
        Dim tabPage3 As New TabPage()
        Dim tabPage4 As New TabPage()
        Dim tabPage5 As New TabPage()

        ' Sizes the tabs so that each row fills the entire width of tabControl1.
        Me.tabControl1.SizeMode = TabSizeMode.FillToRight

        Me.tabControl1.Multiline = True
        Me.tabControl1.Padding = New Point(15, 5)
        Me.tabControl1.Controls.AddRange(New Control() {tabPage1, tabPage2, tabPage3, tabPage4, tabPage5})
        Me.tabControl1.Location = New Point(35, 25)
        Me.tabControl1.Size = New Size(220, 220)

        Me.Size = New Size(300, 300)
        Me.Controls.Add(tabControl1)
    End Sub

    Shared Sub Main()
        Application.Run(New Form1())
    End Sub
End Class


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

public class Form1 : Form
{
    private TabControl tabControl1;

    public Form1()
    {
        this.tabControl1 = new TabControl();
        TabPage tabPage1 = new TabPage();
        TabPage tabPage2 = new TabPage();
        TabPage tabPage3 = new TabPage();
        TabPage tabPage4 = new TabPage();
        TabPage tabPage5 = new TabPage();

        TabPage[] tabPages = {tabPage1, tabPage2, tabPage3, tabPage4, tabPage5};

        // Sizes the tabs so that each row fills the entire width of tabControl1.
        this.tabControl1.SizeMode = TabSizeMode.FillToRight;

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

        this.Size = new Size(300, 300);
        this.Controls.Add(tabControl1);
    }

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


using namespace System::Drawing;
using namespace System::Windows::Forms;
public ref class Form1: public Form
{
private:
   TabControl^ tabControl1;

public:
   Form1()
   {
      this->tabControl1 = gcnew TabControl;
      TabPage^ tabPage1 = gcnew TabPage;
      TabPage^ tabPage2 = gcnew TabPage;
      TabPage^ tabPage3 = gcnew TabPage;
      TabPage^ tabPage4 = gcnew TabPage;
      TabPage^ tabPage5 = gcnew TabPage;
      array<TabPage^>^tabPages = {tabPage1,tabPage2,tabPage3,tabPage4,tabPage5};

      // Sizes the tabs so that each row fills the entire width of tabControl1.
      this->tabControl1->SizeMode = TabSizeMode::FillToRight;
      this->tabControl1->Multiline = true;
      this->tabControl1->Padding = Point(15,5);
      array<Control^>^temp0 = {tabPage1,tabPage2,tabPage3,tabPage4,tabPage5};
      this->tabControl1->Controls->AddRange( temp0 );
      this->tabControl1->Location = Point(35,25);
      this->tabControl1->Size = System::Drawing::Size( 220, 220 );
      this->Size = System::Drawing::Size( 300, 300 );
      this->Controls->Add( tabControl1 );
   }

};

int main()
{
   Application::Run( gcnew Form1 );
}


Version Information

.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
Platforms

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.