Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function draws a rectangle in the style used to indicate that the rectangle has the focus.

Syntax 

BOOL DrawFocusRect(
  HDC 
hDC, 
  const RECT* 
lprc
);

Parameters

hDC

[in] Handle to the device context.

lprc

[in] Long pointer to a RECTstructure that specifies the logical coordinates of the rectangle.

Return Value

Nonzero indicates success. Zero indicates failure.To get extended error information, call GetLastError.

Remarks

Because DrawFocusRectis an XOR function, calling it a second time with the same rectangle removes the rectangle from the screen.

This function draws a rectangle that cannot be scrolled. To scroll an area containing a rectangle drawn by this function, call DrawFocusRectto remove the rectangle from the screen, scroll the area, and then call DrawFocusRectagain to draw the rectangle in the new position.

Requirements

Header windows.h
Library coredll.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

RECT
GDI Functions