ArcTo-Funktion (wingdi.h)

Artikel
03/04/2024

Die ArcTo-Funktion zeichnet einen elliptischen Bogen.

Syntax

BOOL ArcTo(
  [in] HDC hdc,
  [in] int left,
  [in] int top,
  [in] int right,
  [in] int bottom,
  [in] int xr1,
  [in] int yr1,
  [in] int xr2,
  [in] int yr2
);

Parameter

[in] hdc

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

[in] left

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

[in] top

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

[in] right

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

[in] bottom

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

[in] xr1

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

[in] yr1

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

[in] xr2

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

[in] yr2

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

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

ArcTo ähnelt der Arc-Funktion , mit der Ausnahme, dass die aktuelle Position aktualisiert wird.

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 gegen den Uhrzeigersinn von dem Punkt, an dem er die radiale Linie von der Mitte des umgebenden Rechtecks bis zum Punkt (nXRadial1, nYRadial1) überschneidet. Der Bogen endet dort, wo er die radiale Linie von der Mitte des umgebenden Rechtecks bis zum Punkt (nXRadial2, nYRadial2) überschneidet. Wenn Start- und Endpunkt identisch sind, wird eine vollständige Ellipse gezeichnet.

Eine Linie wird von der aktuellen Position zum Ausgangspunkt des Bogens gezeichnet. Wenn kein Fehler auftritt, wird die aktuelle Position auf den Endpunkt des Bogens festgelegt.

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

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