Arc-Funktion (wingdi.h)

Artikel
03/13/2024

Die Arc-Funktion zeichnet einen elliptischen Bogen.

Syntax

BOOL Arc(
  [in] HDC hdc,
  [in] int x1,
  [in] int y1,
  [in] int x2,
  [in] int y2,
  [in] int x3,
  [in] int y3,
  [in] int x4,
  [in] int y4
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext, in dem das Zeichnen stattfindet.

[in] x1

Die x-Koordinate in logischen Einheiten der oberen linken Ecke des umgebenden Rechtecks.

[in] y1

Die y-Koordinate in logischen Einheiten der oberen linken Ecke des umgebenden Rechtecks.

[in] x2

Die x-Koordinate in logischen Einheiten der unteren rechten Ecke des umgebenden Rechtecks.

[in] y2

Die y-Koordinate in logischen Einheiten der unteren rechten Ecke des umgebenden Rechtecks.

[in] x3

Die x-Koordinate in logischen Einheiten des Endpunkts der radialen Linie, die den Startpunkt des Bogens definiert.

[in] y3

Die y-Koordinate in logischen Einheiten des Endpunkts der radialen Linie, die den Startpunkt des Bogens definiert.

[in] x4

Die x-Koordinate in logischen Einheiten des Endpunkts der radialen Linie, die den Endpunkt des Bogens definiert.

[in] y4

Die y-Koordinate in logischen Einheiten des Endpunkts der radialen Linie, die den Endpunkt des Bogens definiert.

Rückgabewert

Wenn der Bogen gezeichnet wird, ist der Rückgabewert nonzero.

Wenn der Bogen nicht gezeichnet wird, ist der Rückgabewert 0.

Hinweise

Die Punkte (nLeftRect, nTopRect) und (nRightRect, nBottomRect) geben das umgebende Rechteck an. Eine Ellipse, die durch das angegebene begrenzungsfähige Rechteck gebildet wird, definiert die Kurve des Bogens. Der Bogen erstreckt sich in der aktuellen Zeichnungsrichtung von dem Punkt, an dem er den Radialpunkt von der Mitte des umgebenden Rechtecks bis zum Punkt (nXStartArc, nYStartArc) überschneidet. Der Bogen endet dort, wo er den Radialen von der Mitte des umgebenden Rechtecks mit dem Punkt (nXEndArc, nYEndArc) überschneidet. Wenn Start- und Endpunkt identisch sind, wird eine vollständige Ellipse gezeichnet.

Der Bogen wird mit dem aktuellen Stift gezeichnet. sie ist nicht gefüllt.

Die aktuelle Position wird von Arc weder verwendet noch aktualisiert.

Verwenden Sie die Funktionen GetArcDirection und SetArcDirection , um die aktuelle Zeichnungsrichtung für einen Gerätekontext abzurufen und festzulegen. Die Standardzeichnungsrichtung ist gegen den Uhrzeigersinn.

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