This documentation is archived and is not being maintained.

TabControl.ItemSize Property

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

[LocalizableAttribute(true)] 
public Size ItemSize { get; set; }
/** @property */
public Size get_ItemSize ()

/** @property */
public void set_ItemSize (Size value)

public function get ItemSize () : Size

public function set ItemSize (value : Size)

Not applicable.

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.

Exception typeCondition

ArgumentOutOfRangeException

The width or height of the Size is less than 0.

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

The following code 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.

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;

    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());
    }
}

import System.Drawing.*;
import System.Windows.Forms.*;

public class Form1 extends 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.set_ItemSize(new Size(90, 50));
      
        // Makes the tab width definable. 
        this.tabControl1.set_SizeMode(TabSizeMode.Fixed);
        this.tabControl1.get_Controls().
            AddRange(new Control[]{tabPage1, tabPage2});
        this.tabControl1.set_Location(new Point(35, 25));
        this.tabControl1.set_Size(new Size(220, 220));
        this.set_Size(new Size(300, 300));
        this.get_Controls().Add(tabControl1);
    } //Form1
   
    public static void main(String[] args)
    {
        Application.Run(new Form1());
    } //main
} //Form1

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0
Show: