Graphics::D rawRectangles(constPen,constRectF,INT)-Methode (gdiplusgraphics.h)

2023-08-24

Die Graphics::D rawRectangles-Methode zeichnet eine Sequenz von Rechtecken.

Syntax

Status DrawRectangles(
  const Pen   *pen,
  const RectF *rects,
  INT         count
);

Parameter

pen

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

rects

Zeiger auf ein Array von RectF-Objekten , die die Koordinaten der zu zeichnenden Rechtecke angeben.

count

Ganzzahl, die die Anzahl der Elemente im Rects-Array angibt.

Rückgabewert

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.

Bemerkungen

Beispiele

Im folgenden Beispiel wird eine Gruppe von Rechtecken gezeichnet.

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

   // Create a Pen object.
   Pen blackPen(Color(255, 0, 0, 0), 3);
   
   // Create an array of RectF objects.
   RectF rect1(0.0f, 0.0f, 100.0f, 200.0f);
   RectF rect2(100.0f, 200.0f, 250.0f, 50.0f);
   RectF rect3(300.0f, 0.0f, 50.0f, 100.0f);
   RectF rects[] = {rect1, rect2, rect3};
   RectF* pRects = rects;

   // Draw the rectangles.
   graphics.DrawRectangles(&blackPen, pRects, 3);
}