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
CreateHatchBrush, CreatePatternBrush, CreateSolidBrush, GetStockObject, RECT