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)

public:
property Size ItemSize {
	Size get();
	void set(Size value);
}

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.

Exception Condition
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 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 );
}

.NET Framework
Available since 1.1
Return to top
Show: