AngleArc-Funktion (wingdi.h)
Die AngleArc-Funktion zeichnet ein Liniensegment und einen Bogen. Das Liniensegment wird von der aktuellen Position bis zum Anfang des Bogens gezeichnet. Der Bogen wird entlang des Umkreises eines Kreises mit dem angegebenen Radius und dem angegebenen Mittelpunkt gezeichnet. Die Länge des Bogens wird durch die angegebenen Start- und Kehrwinkel definiert.
Syntax
BOOL AngleArc(
[in] HDC hdc,
[in] int x,
[in] int y,
[in] DWORD r,
[in] FLOAT StartAngle,
[in] FLOAT SweepAngle
);
Parameter
[in] hdc
Handle für einen Gerätekontext.
[in] x
Gibt die x-Koordinate in logischen Einheiten des Kreismittelpunkts an.
[in] y
Gibt die y-Koordinate in logischen Einheiten des Kreismittelpunkts an.
[in] r
Gibt den Radius des Kreises in logischen Einheiten an. Dieser Wert muss positiv sein.
[in] StartAngle
Gibt den Startwinkel in Grad relativ zur x-Achse an.
[in] SweepAngle
Gibt den Kehrwinkel in Grad relativ zum Startwinkel an.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.
Hinweise
Die AngleArc-Funktion verschiebt die aktuelle Position an den Endpunkt des Bogens.
Der von dieser Funktion gezeichnete Bogen kann je nach aktuellem Transformations- und Zuordnungsmodus elliptisch sein. Vor dem Zeichnen des Bogens zeichnet AngleArc das Liniensegment von der aktuellen Position bis zum Anfang des Bogens.
Der Bogen wird gezeichnet, indem ein imaginärer Kreis um den angegebenen Mittelpunkt mit dem angegebenen Radius erstellt wird. Der Startpunkt des Bogens wird bestimmt, indem von der x-Achse des Kreises gegen den Uhrzeigersinn durch die Anzahl der Grad im Startwinkel gemessen wird. Der Endpunkt befindet sich in ähnlicher Weise, indem er gegen den Uhrzeigersinn vom Startpunkt durch die Anzahl der Grad im Kehrwinkel misst.
Wenn der Kehrwinkel größer als 360 Grad ist, wird der Bogen mehrmals gekehrt.
Diese Funktion zeichnet Linien mit dem aktuellen Stift. Die Abbildung ist nicht gefüllt.
Beispiele
Ein Beispiel finden Sie unter Zeichnen eines Kreisdiagramms.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 (einschließlich Windows.h) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |