TabControl.HotTrack Property

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

TabControl.cs

Gets or sets a value indicating whether the control's tabs change in appearance when the mouse passes over them.

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

public bool HotTrack { get; set; }

member this.HotTrack : bool with get, set

Public Property HotTrack As Boolean

Property Value

Boolean

true if the tabs change in appearance when the mouse passes over them; otherwise, false. The default is false.

Examples

The following code example creates a TabControl with two TabPage objects. The HotTrack property is set to true, which highlights the tab Text myTabPage1 or myTabPage2 when the mouse passes over the tabs.

using namespace System::Drawing;
using namespace System::Windows::Forms;
public ref class Form1: public Form
{
private:
   TabControl^ tabControl1;
   TabPage^ tabPage1;
   TabPage^ tabPage2;
   void MyTabs()
   {
      this->tabControl1 = gcnew TabControl;
      this->tabPage1 = gcnew TabPage;
      this->tabPage2 = gcnew TabPage;
      array<Control^>^tabControls = {this->tabPage1,this->tabPage2};
      this->tabControl1->Controls->AddRange( tabControls );
      this->tabControl1->Padding = Point(15,10);
      this->tabControl1->Location = Point(35,25);
      this->tabControl1->Size = System::Drawing::Size( 220, 220 );
      
      // Highlights TabPage::Text when the mouse passes over tabs.
      this->tabControl1->HotTrack = true;
      this->tabPage1->Text = "myTabPage1";
      this->tabPage2->Text = "myTabPage2";
      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 );
}

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

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

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

        this.tabControl1.Controls.AddRange(new Control[] {
            this.tabPage1,
            this.tabPage2});
        this.tabControl1.Padding = new Point(15, 10);
        this.tabControl1.Location = new Point(35, 25);
        this.tabControl1.Size = new Size(220, 220);

        // Highlights TabPage.Text when the mouse passes over tabs.
        this.tabControl1.HotTrack = true;
    
        this.tabPage1.Text = "myTabPage1";
        this.tabPage2.Text = "myTabPage2";

        this.Size = 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 tabPage2 As TabPage

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

        Me.tabControl1.Controls.AddRange(New Control() {Me.tabPage1, Me.tabPage2})
        Me.tabControl1.Padding = New Point(15, 10)
        Me.tabControl1.Location = New Point(35, 25)
        Me.tabControl1.Size = New Size(220, 220)

        ' Highlights TabPage.Text when the mouse passes over tabs.
        Me.tabControl1.HotTrack = True

        Me.tabPage1.Text = "myTabPage1"
        Me.tabPage2.Text = "myTabPage2"

        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

Remarks

The color that the tab changes to when the mouse is over it is determined by the local computer's system colors. To change the system colors, use Control Panel.