DrawEdge

The DrawEdge function draws one or more edges of rectangle.

BOOL DrawEdge(
  HDC hdc,       // handle to device context
  LPRECT qrc,    // pointer to rectangle coordinates
  UINT edge,     // type of inner and outer edge to draw
  UINT grfFlags  // type of border
);
 

Parameters

hdc
Handle to the device context.
qrc
Pointer to a RECT structure that contains the logical coordinates of the rectangle.
edge
Specifies the type of inner and outer edge to draw. This parameter must be a combination of one inner-border flag and one outer-border flag. The inner-border flags are as follows.
Value Meaning
BDR_RAISEDINNER Raised inner edge.
BDR_SUNKENINNER Sunken inner edge.

The outer-border flags are as follows.
Value Meaning
BDR_RAISEDOUTER Raised outer edge.
BDR_SUNKENOUTER Sunken outer edge.

Alternatively, the edge parameter can specify one of the following flags.
Value Meaning
EDGE_BUMP Combination of BDR_RAISEDOUTER and BDR_SUNKENINNER.
EDGE_ETCHED Combination of BDR_SUNKENOUTER and BDR_RAISEDINNER.
EDGE_RAISED Combination of BDR_RAISEDOUTER and BDR_RAISEDINNER.
EDGE_SUNKEN Combination of BDR_SUNKENOUTER and BDR_SUNKENINNER.

grfFlags
Specifies the type of border. This parameter can be a combination of the following values.
Value Meaning
BF_ADJUST Rectangle to be adjusted to leave space for client area.
BF_BOTTOM Bottom of border rectangle.
BF_BOTTOMLEFT Bottom and left side of border rectangle.
BF_BOTTOMRIGHT Bottom and right side of border rectangle.
BF_DIAGONAL Diagonal border.
BF_DIAGONAL_ENDBOTTOMLEFT Diagonal border. The end point is the bottom-left corner of the rectangle; the origin is top-right corner.
BF_DIAGONAL_ENDBOTTOMRIGHT Diagonal border. The end point is the bottom-right corner of the rectangle; the origin is top-left corner.
BF_DIAGONAL_ENDTOPLEFT Diagonal border. The end point is the top-left corner of the rectangle; the origin is bottom-right corner.
BF_DIAGONAL_ENDTOPRIGHT Diagonal border. The end point is the top-right corner of the rectangle; the origin is bottom-left corner.
BF_FLAT Flat border.
BF_LEFT Left side of border rectangle.
BF_MIDDLE Interior of rectangle to be filled.
BF_MONO One-dimensional border.
BF_RECT Entire border rectangle.
BF_RIGHT Right side of border rectangle.
BF_SOFT Soft buttons instead of tiles.
BF_TOP Top of border rectangle.
BF_TOPLEFT Top and left side of border rectangle.
BF_TOPRIGHT Top and right side of border rectangle.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Windows NT: To get extended error information, call GetLastError.

Remarks

Windows CE: Windows CE does not support the EDGE_BUMP flag for the edge parameter.

Windows CE does not support the following grfFlags values:

BF_BOTTOMLEFT

BF_TOPLEFT

BF_TOPRIGHT

QuickInfo

  Windows NT: Requires version 3.51 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Requires version 1.0 or later.
  Header: Declared in winuser.h.
  Import Library: Use user32.lib.

See Also

Painting and Drawing Overview, Painting and Drawing Functions, RECT