Export (0) Print
Expand All

WidenPath function

The WidenPath function redefines the current path as the area that would be painted if the path were stroked using the pen currently selected into the given device context.

Syntax


BOOL WidenPath(
  _In_  HDC hdc
);

Parameters

hdc [in]

A handle to a device context that contains a closed path.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Error codes

If the function fails, GetLastError may return one of the following error codes:

ERROR_CAN_NOT_COMPLETE
ERROR_INVALID_PARAMETER
ERROR_NOT_ENOUGH_MEMORY

Error codes

If the function fails, GetLastError may return one of the following error codes:

ERROR_CAN_NOT_COMPLETE
ERROR_INVALID_PARAMETER
ERROR_NOT_ENOUGH_MEMORY

Remarks

The WidenPath function is successful only if the current pen is a geometric pen created by the ExtCreatePen function, or if the pen is created with the CreatePen function and has a width, in device units, of more than one.

The device context identified by the hdc parameter must contain a closed path.

Any Bézier curves in the path are converted to sequences of straight lines approximating the widened curves. As such, no Bézier curves remain in the path after WidenPath is called.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

Paths Overview
Path Functions
BeginPath
CreatePen
EndPath
ExtCreatePen
SetMiterLimit

 

 

Community Additions

ADD
Show:
© 2015 Microsoft