Export (0) Print
Expand All

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)

'Declaration
Public Property ItemSize As Size

Property Value

Type: System.Drawing.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.

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

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

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Show:
© 2014 Microsoft