WidenPath

  BOOL WidenPath(hdc)    
  HDC hdc;    

The WidenPath function modifies the current path, transforming the path into one which represents the area which would be painted if the path were stroked with the pen currently selected into the DC.

Parameters

hdc

Identifies the device context of the path.

Return Value

The return value is TRUE if the function was successful, or FALSE if an error occurred. Use the GetLastError function to obtain extended error information.

Comments

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

The DC must have an inactive path bracket, started by calling BeginPath and ended by calling EndPath.

FillPath with a winding fill on the resulting path may be called to yield the equivalent of StrokePath.

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

Errors

Use the GetLastError function to retrieve the error value, which may be one of the following:

ERROR_INVALID_MODE  
ERROR_INVALID_PARAMETER  
ERROR_NOT_ENOUGH_MEMORY  

See Also

BeginPath, EndPath, SetMiterLimit