Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
DrawThemeEdge
Collapse the table of content
Expand the table of content

DrawThemeEdge function

Draws one or more edges defined by the visual style of a rectangle.

Syntax


HRESULT DrawThemeEdge(
  _In_  HTHEME  hTheme,
  _In_  HDC     hdc,
  _In_  int     iPartId,
  _In_  int     iStateId,
  _In_  LPCRECT pDestRect,
  _In_  UINT    uEdge,
  _In_  UINT    uFlags,
  _Out_ LPRECT  pContentRect
);

Parameters

hTheme [in]

Type: HTHEME

Handle to a window's specified theme data. Use OpenThemeData to create an HTHEME.

hdc [in]

Type: HDC

HDC.

iPartId [in]

Type: int

Value of type int that specifies the part that contains the rectangle. See Parts and States.

iStateId [in]

Type: int

Value of type int that specifies the state of the part. See Parts and States.

pDestRect [in]

Type: LPCRECT

Pointer to a RECT structure that contains, in logical coordinates, the rectangle.

uEdge [in]

Type: UINT

UINT that specifies 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, or one of the combination flags. The border flags are:

ValueMeaning
BDR_RAISEDINNER

Raised inner edge

BDR_SUNKENINNER

Sunken inner edge

BDR_RAISEDOUTER

Raised outer edge

BDR_SUNKENOUTER

Sunken outer edge

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

 

uFlags [in]

Type: UINT

UINT that specifies the type of border to draw. This parameter can be a combination of the following values.

ValueMeaning
BF_ADJUST

The rectangle pointed to by the pDestRect parameter is shrunk to exclude the edges that were drawn; otherwise the rectangle does not change.

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 lower-left corner of the rectangle; the origin is the upper-right corner.

BF_DIAGONAL_ENDBOTTOMRIGHT

Diagonal border. The end point is the lower-right corner of the rectangle; the origin is the upper-left corner.

BF_DIAGONAL_ENDTOPLEFT

Diagonal border. The end point is the upper-left corner of the rectangle; the origin is the lower-right corner.

BF_DIAGONAL_ENDTOPRIGHT

Diagonal border. The end point is the upper-right corner of the rectangle; the origin is the lower-left corner.

BF_FLAT

Flat border.

BF_LEFT

Left side of border rectangle.

BF_MIDDLE

Interior of the rectangle is 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.

 

pContentRect [out]

Type: LPRECT

Pointer to a RECT structure that contains, in logical coordinates, the rectangle that receives the interior rectangle, if uFlags is set to BF_ADJUST. This parameter may be set to NULL.

Return value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Uxtheme.h

Library

UxTheme.lib

DLL

UxTheme.dll

See also

Property Identifiers

 

 

Community Additions

ADD
Show:
© 2015 Microsoft