TabPage.Text Property

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gets or sets the text to display on the tab.

public:
 virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Browsable(true)]
public override string Text { get; set; }

[<System.ComponentModel.Browsable(true)>]
member this.Text : string with get, set

Public Overrides Property Text As String

Property Value

String

The text to display on the tab.

Attributes

BrowsableAttribute

Examples

The following code example creates a TabControl with one TabPage. The Text property sets the tab page text to myTabPage.

using namespace System::Drawing;
using namespace System::Windows::Forms;
public ref class Form1: public Form
{
private:
   TabControl^ tabControl1;
   TabPage^ tabPage1;
   void MyTabs()
   {
      this->tabControl1 = gcnew TabControl;
      this->tabPage1 = gcnew TabPage;
      array<Control^>^tabControl1Controls = {this->tabPage1};
      this->tabControl1->Controls->AddRange( tabControl1Controls );
      this->tabControl1->Location = Point(25,25);
      this->tabControl1->Size = System::Drawing::Size( 250, 250 );
      
      // Displays a string, myTabPage, on tabPage1.
      this->tabPage1->Text = "myTabPage";
      this->ClientSize = System::Drawing::Size( 300, 300 );
      array<Control^>^formControls = {this->tabControl1};
      this->Controls->AddRange( formControls );
   }


public:
   Form1()
   {
      MyTabs();
   }

};

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

using System.Drawing;
using System.Windows.Forms;

public class Form1 : Form
{
    private TabControl tabControl1;
    private TabPage tabPage1;

    private void MyTabs()
    {
        this.tabControl1 = new TabControl();
        this.tabPage1 = new TabPage();

        this.tabControl1.Controls.AddRange(new Control[] {
            this.tabPage1});
        this.tabControl1.Location = new Point(25, 25);
        this.tabControl1.Size = new Size(250, 250);

        // Displays a string, myTabPage, on tabPage1.
        this.tabPage1.Text = "myTabPage";

        this.ClientSize = new Size(300, 300);
        this.Controls.AddRange(new Control[] {
            this.tabControl1});
    }

    public Form1()
    {
        MyTabs();
    }

    static void Main() 
    {
        Application.Run(new Form1());
    }
}

Imports System.Drawing
Imports System.Windows.Forms

Public Class Form1
    Inherits Form
    Private tabControl1 As TabControl
    Private tabPage1 As TabPage


    Private Sub MyTabs()
        Me.tabControl1 = New TabControl()
        Me.tabPage1 = New TabPage()

        Me.tabControl1.Controls.AddRange(New Control() {Me.tabPage1})
        Me.tabControl1.Location = New Point(25, 25)
        Me.tabControl1.Size = New Size(250, 250)

        ' Displays a string, myTabPage, on tabPage1.
        Me.tabPage1.Text = "myTabPage"

        Me.ClientSize = 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

Remarks

Changing the Text property value does not automatically center the new value on the tab if the TabControl has a SizeMode property value of Fixed. You can work around this limitation by setting the TabControl.ItemSize property or by removing the TabPage from the TabControl.TabPages collection and adding it back to the collection. Both of these actions will automatically center the text.