AngleArc-Funktion (wingdi.h)

Artikel
08/27/2023

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