Export (0) Print
Expand All

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. 
	private void Button1_Click(System.Object sender, System.EventArgs e)
	{
		ControlPaint.DrawFocusRectangle(Graphics.FromHwnd(Button2.Handle), 
			Button2.ClientRectangle);
	}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft