Graphics::D rawLines(constPen,constPoint,INT)-Methode (gdiplusgraphics.h)

Artikel
08/24/2023

Die Graphics::D rawLines-Methode zeichnet eine Sequenz verbundener Linien.

Syntax

Status DrawLines(
  [in] const Pen   *pen,
  [in] const Point *points,
  [in] INT         count
);

Parameter

[in] pen

Typ: const Pen*

Zeiger auf einen Stift, der zum Zeichnen der Linien verwendet wird.

[in] points

Typ: const Point*

Zeiger auf ein Array von Point-Objekten , die die Anfangs- und Endpunkte der Linien angeben.

[in] count

Typ: INT

Ganzzahl, die die Anzahl der Elemente im Punktarray angibt.

Rückgabewert

Typ: Status

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

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Jede Zeile erfordert einen Ausgangspunkt und einen Endpunkt. Der Endpunkt jeder Zeile ist der Ausgangspunkt für die nächste.

Beispiele

Im folgenden Beispiel wird eine Abfolge verbundener Linien erstellt.


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

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

   // Create an array of Point objects that define the lines to draw.
   Point point1(10, 10);
   Point point2(10, 100);
   Point point3(200, 50);
   Point point4(250, 300);

   Point points[4] = {point1, point2, point3, point4};
   Point* pPoints = points;

   // Draw the lines.
   graphics.DrawLines(&blackPen, pPoints, 4);
}

Anforderungen


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