This documentation is archived and is not being maintained.

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)

public override Rectangle DisplayRectangle { get; }

Property Value

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

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.


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());
    }
}


.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

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.
Show: