Kreisfunktion (wingdi.h)

Artikel
03/13/2024

Die Pie-Funktion zeichnet einen kreisförmigen Keil, der durch den Schnittpunkt einer Ellipse und zwei Radialen begrenzt ist. Der Kreis wird mithilfe des aktuellen Stifts umrandet und mit dem aktuellen Pinsel gefüllt.

Syntax

BOOL Pie(
  [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] left

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

[in] top

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

[in] right

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

[in] bottom

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

[in] xr1

Die x-Koordinate in logischen Koordinaten des Endpunkts des ersten Radials.

[in] yr1

Die y-Koordinate in logischen Koordinaten des Endpunkts des ersten Radials.

[in] xr2

Die x-Koordinate in logischen Koordinaten des Endpunkts des zweiten Radials.

[in] yr2

Die y-Koordinate in logischen Koordinaten des Endpunkts des zweiten Radials.

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 Kreises wird durch eine Ellipse definiert, die zum angegebenen Begrenzungsrechteck 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.

Die aktuelle Position wird von der Pie-Funktion weder verwendet noch aktualisiert.

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