Gets or sets the size of the control's tabs.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Syntax . . :: . Size
A Size that represents the size of the tabs. The default automatically sizes the tabs to fit the icons and labels on the tabs.
Public Property ItemSize As Sizepublic Size ItemSize { get; set; }public:
property Size ItemSize {
Size get ();
void set (Size value);
}member ItemSize : Size with get, set
Property Value
Type: System.DrawingA 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 | Condition |
|---|---|
| ArgumentOutOfRangeException | The width or height of the Size is less than 0. |
Examples
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.
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
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());
}
}
using namespace System::Drawing;
using namespace System::Windows::Forms;
public ref class Form1: public Form
{
private:
TabControl^ tabControl1;
TabPage^ tabPage1;
TabPage^ tabPage2;
public:
Form1()
{
this->tabControl1 = gcnew TabControl;
this->tabPage1 = gcnew TabPage;
this->tabPage2 = gcnew TabPage;
// Sizes the tabs of tabControl1.
this->tabControl1->ItemSize = System::Drawing::Size( 90, 50 );
// Makes the tab width definable.
this->tabControl1->SizeMode = TabSizeMode::Fixed;
array<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( gcnew Form1 );
}
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.