Akkordfunktion (wingdi.h)

Artikel
08/27/2023

Die Chord-Funktion zeichnet einen Akkord (einen Bereich, der durch den Schnittpunkt einer Ellipse und eines Liniensegments begrenzt wird, der als Secant bezeichnet wird). Der Akkord wird mithilfe des aktuellen Stifts umrissen und mit dem aktuellen Pinsel gefüllt.

Syntax

BOOL Chord(
  [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 der Akkord angezeigt wird.

[in] x1

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

[in] y1

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

[in] x2

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

[in] y2

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

[in] x3

Die x-Koordinate in logischen Koordinaten des Endpunkts des Radials, der den Anfang des Akkords definiert.

[in] y3

Die y-Koordinate in logischen Koordinaten des Endpunkts des Radials, der den Anfang des Akkords definiert.

[in] x4

Die x-Koordinate in logischen Koordinaten des Endpunkts des Radials, der das Ende des Akkords definiert.

[in] y4

Die y-Koordinate in logischen Koordinaten des Endpunkts des Radials, der das Ende des Akkords 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

Die Kurve des Akkords wird durch eine Ellipse definiert, die auf das angegebene begrenzungsfähige Rechteck passt. Die Kurve beginnt an dem Punkt, an dem die Ellipse das erste Radial überschneidet, und erstreckt sich gegen den Uhrzeigersinn bis zu dem Punkt, an dem die Ellipse das zweite Radial überschneidet. Der Akkord wird geschlossen, indem eine Linie vom Schnittpunkt des ersten Radials und der Kurve zum Schnittpunkt des zweiten Radials und der Kurve gezeichnet wird.

Wenn Start- und Endpunkt der Kurve identisch sind, wird eine vollständige Ellipse gezeichnet.

Die aktuelle Position wird von Chord weder verwendet noch aktualisiert.

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 (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll