DrawFocusRect

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

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

Parameters

  • hDC
    [in] Handle to the device context.
  • lprc
    [in] Long pointer to a RECT structure that specifies the logical coordinates of the rectangle.

Return Values

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

Remarks

Because DrawFocusRect is 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 DrawFocusRect to remove the rectangle from the screen, scroll the area, and then call DrawFocusRect again to draw the rectangle in the new position.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Windows.h.
Link Library: Coredll.lib.

See Also

RECT | GDI Functions

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.