DrawEdge Function
DrawEdge Function

The DrawEdge function draws one or more edges of rectangle.

Syntax

BOOL DrawEdge(
  __in     HDC hdc,
  __inout  LPRECT qrc,
  __in     UINT edge,
  __in     UINT grfFlags
);

Parameters

hdc [in]

A handle to the device context.

qrc [in, out]

A pointer to a RECT structure that contains the logical coordinates of the rectangle.

edge [in]

The type of inner and outer edges 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.

ValueMeaning
BDR_RAISEDINNER

Raised inner edge.

BDR_SUNKENINNER

Sunken inner edge.

 

The outer-border flags are as follows.

ValueMeaning
BDR_RAISEDOUTER

Raised outer edge.

BDR_SUNKENOUTER

Sunken outer edge.

 

Alternatively, the edge parameter can specify one of the following flags.

ValueMeaning
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 [in]

The type of border. This parameter can be a combination of the following values.

ValueMeaning
BF_ADJUST

If this flag is passed, shrink the rectangle pointed to by the qrc parameter to exclude the edges that were drawn.

If this flag is not passed, then do not change the rectangle pointed to by the qrc parameter.

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 Value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Requirements

Minimum supported clientWindows 2000 Professional
Minimum supported serverWindows 2000 Server
HeaderWinuser.h (include Windows.h)
LibraryUser32.lib
DLLUser32.dll

See Also

Painting and Drawing Overview
Painting and Drawing Functions
RECT

Send comments about this topic to Microsoft

Build date: 11/16/2009

© 2010 Microsoft Corporation. All rights reserved.   Terms of Use | Trademarks | Privacy Statement
Page view tracker
Rate the Lightweight library
x
Lightweight builds on ScriptFree (loband) by adding features you've requested: a SearchBox and default code language selection.
Do you like the SearchBox?
Do you like the tabbed code blocks?
How useful is this topic?
Tell us more.
Thanks
x
You're helping to improve MSDN Online.
Feedback
Switch View
Classic
Lightweight Beta
ScriptFree
Switch View