DrawFocusRect

A version of this page is also available for

Windows Embedded CE 6.0 R3

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 RECT structure 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 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

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