BeginPath-Funktion (wingdi.h)
Die BeginPath-Funktion öffnet eine Pfadklammer im angegebenen Gerätekontext.
Syntax
BOOL BeginPath(
[in] HDC hdc
);
Parameter
[in] hdc
Ein Handle für den Gerätekontext.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Nachdem eine Pfadklammer geöffnet wurde, kann eine Anwendung mit dem Aufrufen von GDI-Zeichenfunktionen beginnen, um die Punkte zu definieren, die sich im Pfad befinden. Eine Anwendung kann eine offene Pfadklammer durch Aufrufen der EndPath-Funktion schließen.
Wenn eine Anwendung BeginPath für einen Gerätekontext aufruft, werden alle vorherigen Pfade aus diesem Gerätekontext verworfen. Die folgende Liste zeigt, welche Zeichnungsfunktionen verwendet werden können.
- AngleArc
- Arc
- ArcTo
- Chord
- CloseFigure
- Ellipse
- ExtTextOut
- Lineto
- MoveToEx
- Kreis
- PolyBezier
- PolyBezierTo
- PolyDraw
- Polygon
- Polylinie
- PolylineTo
- PolyPolygon
- PolyPolyline
- Rechteck
- RoundRect
- Textout
Beispiele
Ein Beispiel finden Sie unter Verwenden von Pfaden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |