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:
property Rectangle DisplayRectangle {
	virtual Rectangle get() override;
}

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

.NET Framework
Available since 1.1
Return to top
Show: