FrameRect
The FrameRect
function draws a border around the specified rectangle by using the specified
brush. The width and height of the border are always one logical unit.
int FrameRect(
|
HDC hDC, |
// handle to device
context |
|
CONST RECT *lprc, |
// pointer to
rectangle coordinates |
|
HBRUSH hbr |
// handle to brush |
|
); |
|
Parameters
hDC
Identifies
the device context in which the border is drawn.
lprc
Points to a RECT structure that contains the
logical coordinates of the upper-left and lower-right corners of the rectangle.
hbr
Identifies
the brush used to draw the border.
Return Values
If the
function succeeds, the return value is TRUE.
If the
function fails, the return value is FALSE. To get extended error information,
call GetLastError.
Remarks
The brush
identified by the hbr parameter must have been created by using the CreateHatchBrush,
CreatePatternBrush, or CreateSolidBrush function, or retrieved by
using the GetStockObject function.
If the bottom
member of the RECT structure is less than or equal to the top
member, or if the right member is less than or equal to the left
member, the function does not draw the rectangle.
See Also