ControlPaint::DrawFocusRectangle Method (Graphics^, Rectangle, Color, Color)

 

Draws a focus rectangle on the specified graphics surface and within the specified bounds.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public:
static void DrawFocusRectangle(
	Graphics^ graphics,
	Rectangle rectangle,
	Color foreColor,
	Color backColor
)

Parameters

graphics
Type: System.Drawing::Graphics^

The Graphics to draw on.

rectangle
Type: System.Drawing::Rectangle

The Rectangle that represents the dimensions of the grab handle glyph.

foreColor
Type: System.Drawing::Color

The Color that is the foreground color of the object to draw the focus rectangle on.

backColor
Type: System.Drawing::Color

The Color that is the background color of the object to draw the focus rectangle on.

A focus rectangle is a dotted rectangle that Windows uses to indicate what control has the current keyboard focus.

The following code example demonstrates using the DrawFocusRectangle method and the Control::Handle property. To run this example, paste the following code in a form. Add two buttons named Button1 and Button2 to the form and ensure all events are connected to their event handlers.

// This method draws a focus rectangle on Button2 using the 
// handle and client rectangle of Button2.
void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   ControlPaint::DrawFocusRectangle( Graphics::FromHwnd( Button2->Handle ), Button2->ClientRectangle );
}

.NET Framework
Available since 1.1
Return to top
Show: