TabControl::Multiline Property

 

Gets or sets a value indicating whether more than one row of tabs can be displayed.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public:
property bool Multiline {
	bool get();
	void set(bool value);
}

Property Value

Type: System::Boolean

true if more than one row of tabs can be displayed; otherwise, false. The default is false.

If Multiline is false, only one row of tabs is displayed, even if all the tabs do not fit in the available space. In that case, however, arrows are displayed that enable the user to navigate to the undisplayed tabs.

If the Multiline property is changed to false while the Alignment property is set to Left or Right, the Alignment property is automatically reset to Top.

The following code example creates a TabControl with four TabPage objects. The Multiline property is set to true, which displays two rows of tabs instead of one.

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;
   TabPage^ tabPage3;
   TabPage^ tabPage4;
   void MyTabs()
   {
      this->tabControl1 = gcnew TabControl;
      this->tabPage1 = gcnew TabPage;
      this->tabPage2 = gcnew TabPage;
      this->tabPage3 = gcnew TabPage;
      this->tabPage4 = gcnew TabPage;

      // Allows more than one row of tabs.
      this->tabControl1->Multiline = true;
      this->tabControl1->Padding = Point(22,5);
      array<Control^>^tabControls = {this->tabPage1,this->tabPage2,this->tabPage3,this->tabPage4};
      this->tabControl1->Controls->AddRange( tabControls );
      this->tabControl1->Location = Point(35,25);
      this->tabControl1->Size = System::Drawing::Size( 220, 220 );
      this->tabPage1->Text = "myTabPage1";
      this->tabPage2->Text = "myTabPage2";
      this->tabPage3->Text = "myTabPage3";
      this->tabPage4->Text = "myTabPage4";
      this->Size = System::Drawing::Size( 300, 300 );
      array<Control^>^formControls = {this->tabControl1};
      this->Controls->AddRange( formControls );
   }


public:
   Form1()
   {
      MyTabs();
   }

};

int main()
{
   Application::Run( gcnew Form1 );
}

.NET Framework
Available since 1.1
Return to top
Show: