Freigeben über


Graphics::D rawPie(constPen*,INT,INT,INT,REAL,REAL)-Methode (gdiplusgraphics.h)

Die Graphics::D rawPie-Methode zeichnet einen Kreis.

Syntax

Status DrawPie(
  [in] const Pen *pen,
  [in] INT       x,
  [in] INT       y,
  [in] INT       width,
  [in] INT       height,
  [in] REAL      startAngle,
  [in] REAL      sweepAngle
);

Parameter

[in] pen

Typ: const Pen*

Zeiger auf einen Stift, der zum Zeichnen des Kreises verwendet wird.

[in] x

Typ: INT

Ganzzahl, die die x-Koordinate der oberen linken Ecke des Rechtecks angibt, die die Ellipse eingrenzt, in der der Kreis gezeichnet werden soll.

[in] y

Typ: INT

Ganzzahl, die die y-Koordinate der oberen linken Ecke des Rechtecks angibt, das die Ellipse umgrenzt, in der der Kreis gezeichnet werden soll.

[in] width

Typ: INT

Ganzzahl, die die Breite des Rechtecks angibt, das die Ellipse umgrenzt, in der der Kreis gezeichnet werden soll.

[in] height

Typ: INT

Ganzzahl, die die Höhe des Rechtecks angibt, das die Ellipse umgrenzt, in der der Kreis gezeichnet werden soll.

[in] startAngle

Typ: REAL

Reelle Zahl, die den Winkel in Grad zwischen der x-Achse und dem Startpunkt des Bogens angibt, der den Kreis definiert. Ein positiver Wert gibt die Drehung im Uhrzeigersinn an.

[in] sweepAngle

Typ: REAL

Reelle Zahl, die den Winkel in Grad zwischen dem Anfangs- und Endpunkt des Bogens angibt, der den Kreis definiert. Ein positiver Wert gibt die Drehung im Uhrzeigersinn an.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Die folgende Abbildung zeigt den Kreis, der in der Ellipse gezeichnet wird, die durch das Rechteck begrenzt ist. Die Abbildung zeigt auch die horizontale Achse der Ellipse und die Richtung der startAngle und der SweepAngle.

Abbildung einer Ellipse mit einem umrissenen Kreis; Startwinkel und Kehrwinkel sind beschriftet

Beispiele

Das folgende Beispiel zeichnet einen Kreis.


VOID Example_DrawPie3(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a Pen object.
   Pen blackPen(Color(255, 0, 0, 0), 3);

   // Define the pie.
   int x = 0;
   int y = 0;
   int width = 200;
   int height = 100;
   REAL startAngle = 0.0f;
   REAL sweepAngle = 45.0f;

   // Draw the pie.
   graphics.DrawPie(&blackPen, x, y, width, height, startAngle, sweepAngle);
}

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile gdiplusgraphics.h (include Gdiplus.h)
Bibliothek Gdiplus.lib
DLL Gdiplus.dll

Weitere Informationen

FillPie-Methoden

Grafiken

Geöffnete und geschlossene Kurven

Rect