Skip to main content
.NET Framework Class Library
TabControl..::.DisplayRectangle Property

Gets the display area of the control's tab pages.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Syntax
Public Overrides ReadOnly Property DisplayRectangle As Rectangle
public override Rectangle DisplayRectangle { get; }
public:
virtual property Rectangle DisplayRectangle {
	Rectangle get () override;
}
abstract DisplayRectangle : Rectangle
override DisplayRectangle : Rectangle

Property Value

Type: System.Drawing..::.Rectangle
A Rectangle that represents the display area of the tab pages.
Examples

The following code example creates a TabControl with one TabPage. This example uses the DisplayRectangle property to draw a Rectangle representing the tab page display area of tabControl1. Notice that the example uses the Inflate method; otherwise, the TabPage drawing code overwrites the Rectangle drawn in the DrawOnTabPage method.

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 myTabRect As Rectangle

   Public Sub New()
      Dim tabControl1 As New TabControl()
      Dim tabPage1 As New TabPage()

      tabControl1.DrawMode = TabDrawMode.OwnerDrawFixed
      tabControl1.Appearance = TabAppearance.Buttons
      tabControl1.Location = New Point(25, 25)
      tabControl1.Controls.Add(tabPage1)
      Controls.Add(tabControl1)

      ' Gets a Rectangle that represents the tab page display area of tabControl1.
      myTabRect = tabControl1.DisplayRectangle

      myTabRect.Inflate(1, 1)
      AddHandler tabControl1.DrawItem, AddressOf DrawOnTabPage
   End Sub

   Private Sub DrawOnTabPage(sender As Object, e As DrawItemEventArgs)
      Dim g As Graphics = e.Graphics
      Dim p As New Pen(Color.Blue)
      g.DrawRectangle(p, myTabRect)
   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 Rectangle myTabRect;

    public Form1()
    {
        TabControl tabControl1 = new TabControl();
        TabPage tabPage1 = new TabPage();

        tabControl1.DrawMode = TabDrawMode.OwnerDrawFixed;
        tabControl1.Appearance = TabAppearance.Buttons;
        tabControl1.Location = new Point(25, 25);
        tabControl1.Controls.Add(tabPage1);
        Controls.Add(tabControl1);

        // Gets a Rectangle that represents the tab page display area of tabControl1.
        myTabRect = tabControl1.DisplayRectangle;

        myTabRect.Inflate(1, 1); 
        tabControl1.DrawItem += new DrawItemEventHandler(DrawOnTabPage);
    }

    private void DrawOnTabPage(object sender, DrawItemEventArgs e)
    {
        Graphics g = e.Graphics;
        Pen p = new Pen(Color.Blue);
        g.DrawRectangle(p, myTabRect);
    }

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


using namespace System::Drawing;
using namespace System::Windows::Forms;
public ref class Form1: public Form
{
private:
   Rectangle myTabRect;

public:
   Form1()
   {
      TabControl^ tabControl1 = gcnew TabControl;
      TabPage^ tabPage1 = gcnew TabPage;
      tabControl1->DrawMode = TabDrawMode::OwnerDrawFixed;
      tabControl1->Appearance = TabAppearance::Buttons;
      tabControl1->Location = Point(25,25);
      tabControl1->Controls->Add( tabPage1 );
      Controls->Add( tabControl1 );

      // Gets a Rectangle that represents the tab page display area of tabControl1.
      myTabRect = tabControl1->DisplayRectangle;
      myTabRect.Inflate( 1, 1 );
      tabControl1->DrawItem += gcnew DrawItemEventHandler( this, &Form1::DrawOnTabPage );
   }


private:
   void DrawOnTabPage( Object^ /*sender*/, DrawItemEventArgs^ e )
   {
      Graphics^ g = e->Graphics;
      Pen^ p = gcnew Pen( Color::Blue );
      g->DrawRectangle( p, myTabRect );
   }

};

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


Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.