Gets or sets the area of the control (for example, along the top) where the tabs are aligned.
Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms (in System.Windows.Forms.dll)
Visual Basic (Declaration)
Public Property Alignment As TabAlignment
Dim instance As TabControl
Dim value As TabAlignment
value = instance.Alignment
instance.Alignment = value
public TabAlignment Alignment { get; set; }
public:
property TabAlignment Alignment {
TabAlignment get ();
void set (TabAlignment value);
}
public function get Alignment () : TabAlignment
public function set Alignment (value : TabAlignment)
When the Alignment property is set to Left or Right, the Multiline property is automatically set to true.
When you set the Appearance property to FlatButtons, it only appears as such when the Alignment property is set to Top. Otherwise, the Appearance property displays as if set to the Buttons value.
When you set the Appearance property to Buttons, you must also set the Alignment property to Top so that the buttons display correctly.
Note: |
|---|
When you set the Appearance property to Buttons, you must also set the Alignment property to Top so that the tab page contents display correctly. Additionally, when visual styles are enabled, and the Alignment property is set to a value other than Top, the tab contents may not render correctly. |
The following code example creates a TabControl with three TabPage objects. The Alignment property is set to Left, which positions the tabs of tabControl1 on the left side.
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
Private tabPage3 As TabPage
Private Sub MyTabs()
Me.tabControl1 = New TabControl()
Me.tabPage1 = New TabPage()
Me.tabPage2 = New TabPage()
Me.tabPage3 = New TabPage()
' Positions tabs on the left side of tabControl1.
Me.tabControl1.Alignment = System.Windows.Forms.TabAlignment.Left
Me.tabControl1.Controls.AddRange(New Control() {Me.tabPage1, Me.tabPage2, Me.tabPage3})
Me.tabControl1.Location = New Point(16, 24)
Me.tabControl1.SelectedIndex = 0
Me.tabControl1.Size = New Size(248, 232)
Me.tabControl1.TabIndex = 0
Me.tabPage1.TabIndex = 0
Me.tabPage2.TabIndex = 1
Me.tabPage3.TabIndex = 2
Me.Size = New Size(300, 300)
Me.Controls.AddRange(New Control() {Me.tabControl1})
End Sub
Public Sub New()
MyTabs()
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;
private TabPage tabPage3;
private void MyTabs()
{
this.tabControl1 = new TabControl();
this.tabPage1 = new TabPage();
this.tabPage2 = new TabPage();
this.tabPage3 = new TabPage();
// Positions tabs on the left side of tabControl1.
this.tabControl1.Alignment = System.Windows.Forms.TabAlignment.Left;
this.tabControl1.Controls.AddRange(new Control[] {
this.tabPage1,
this.tabPage2,
this.tabPage3});
this.tabControl1.Location = new Point(16, 24);
this.tabControl1.SelectedIndex = 0;
this.tabControl1.Size = new Size(248, 232);
this.tabControl1.TabIndex = 0;
this.tabPage1.TabIndex = 0;
this.tabPage2.TabIndex = 1;
this.tabPage3.TabIndex = 2;
this.Size = new Size(300,300);
this.Controls.AddRange(new Control[] {
this.tabControl1});
}
public Form1()
{
MyTabs();
}
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;
TabPage^ tabPage3;
void MyTabs()
{
this->tabControl1 = gcnew TabControl;
this->tabPage1 = gcnew TabPage;
this->tabPage2 = gcnew TabPage;
this->tabPage3 = gcnew TabPage;
// Positions tabs on the left side of tabControl1.
this->tabControl1->Alignment = System::Windows::Forms::TabAlignment::Left;
array<Control^>^tabControls = {this->tabPage1,this->tabPage2,this->tabPage3};
this->tabControl1->Controls->AddRange( tabControls );
this->tabControl1->Location = Point(16,24);
this->tabControl1->SelectedIndex = 0;
this->tabControl1->Size = System::Drawing::Size( 248, 232 );
this->tabControl1->TabIndex = 0;
this->tabPage1->TabIndex = 0;
this->tabPage2->TabIndex = 1;
this->tabPage3->TabIndex = 2;
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 );
}
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
.NET Framework
Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Reference