DrawFocusRect

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

At a Glance

Header file: Wingdi.h
Windows CE versions: 1.0 and later

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 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.

See Also

RECT