This documentation is archived and is not being maintained.

TabControl.ItemSize Property

Gets or sets the size of the control's tabs.

[Visual Basic]
Public Property ItemSize As Size
[C#]
public Size ItemSize {get; set;}
[C++]
public: __property Size get_ItemSize();
public: __property void set_ItemSize(Size);
[JScript]
public function get ItemSize() : Size;
public function set ItemSize(Size);

Property Value

A Size that represents the size of the tabs. The default automatically sizes the tabs to fit the icons and labels on the tabs.

Exceptions

Exception Type Condition
ArgumentException The width or height of the Size is less than 0.

Remarks

To change the Width property of the ItemSize property, the SizeMode property must be set to Fixed.

Example

[Visual Basic, C#, C++] The following example creates a TabControl with two TabPage objects. To define the dimensions of the tabs, set the ItemSize property equal to a Size structure. In this example, Size defines the tabs 90 pixels wide and 50 pixels high. You cannot change the width of the tabs unless the SizeMode property is set to the Fixed value.

[Visual Basic, C#, C++] Use the System.Drawing and System.Windows.Forms namespaces for this example.

[Visual Basic] 
Imports System.Drawing
Imports System.Windows.Forms

Public Class Form1
    Inherits Form
    Private tabControl1 As TabControl
    Private tabPage1 As TabPage
    Private tabPage2 As TabPage

    Public Sub New()
        Me.tabControl1 = New TabControl()
        Me.tabPage1 = New TabPage()
        Me.tabPage2 = New TabPage()

        ' Sizes the tabs of tabControl1.
        Me.tabControl1.ItemSize = New Size(90, 50)

        ' Makes the tab width definable. 
        Me.tabControl1.SizeMode = TabSizeMode.Fixed

        Me.tabControl1.Controls.AddRange(New Control() {tabPage1, tabPage2})
        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

[C#] 
using System.Drawing;
using System.Windows.Forms;

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

    public Form1()
    {
        this.tabControl1 = new TabControl();
        this.tabPage1 = new TabPage();
        this.tabPage2 = new TabPage();
        
        // Sizes the tabs of tabControl1.
        this.tabControl1.ItemSize = new Size(90, 50);

        // Makes the tab width definable. 
        this.tabControl1.SizeMode = TabSizeMode.Fixed;

        this.tabControl1.Controls.AddRange(new Control[] {
            tabPage1, tabPage2});
        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());
    }
}

[C++] 
using namespace System::Drawing;
using namespace System::Windows::Forms;

public __gc class Form1 : public Form {
private:
    TabControl*  tabControl1;
    TabPage*  tabPage1;
    TabPage*  tabPage2;

public:
    Form1() {
        this->tabControl1 = new TabControl();
        this->tabPage1 = new TabPage();
        this->tabPage2 = new TabPage();

        // Sizes the tabs of tabControl1.
        this->tabControl1->ItemSize = System::Drawing::Size(90, 50);

        // Makes the tab width definable. 
        this->tabControl1->SizeMode = TabSizeMode::Fixed;

        Control* tabControl1Controls[] = {tabPage1, tabPage2};
        this->tabControl1->Controls->AddRange(tabControl1Controls);
        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(new Form1());
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

TabControl Class | TabControl Members | System.Windows.Forms Namespace | Size

Show: