The BeginPath function opens a path bracket in the specified device context.
BOOL BeginPath(
| HDC hdc | // handle to device context |
| ); |
Parameters
hdc
Identifies the device context.
Return Values
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
Remarks
After a path bracket is open, an application can begin calling GDI drawing functions to define the points that lie in the path. An application can close an open path bracket by calling the EndPath function.
When an application calls BeginPath for a device context, any previous paths are discarded from that device context.
Windows NT:
The following drawing functions define points in a path:
| AngleArc | LineTo | Polyline |
| Arc | MoveToEx | PolylineTo |
| ArcTo | Pie | PolyPolygon |
| Chord | PolyBezier | PolyPolyline |
| CloseFigure | PolyBezierTo | Rectangle |
| Ellipse | PolyDraw | RoundRect |
| ExtTextOut | Polygon | TextOut |
Windows 95:
When constructing a path, only the CloseFigure, ExtTextOut, LineTo, MoveToEx, PolyBezier, PolyBezierTo, Polygon, Polyline, PolylineTo, PolyPolygon, PolyPolyline, and TextOut functions are recorded.
See Also
EndPath, FillPath, PathToRegion, SelectClipPath, StrokeAndFillPath, StrokePath, WidenPath