Graphics：:D rawRectangles (constPen，constRectF，INT) 方法 (gdiplusgraphics.h)

發行項
08/24/2023

Graphics：:D rawRectangles方法會繪製一連串的矩形。

語法

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

參數

pen

用來繪製矩形的手寫筆指標。

rects

RectF物件的陣列指標，指定要繪製之矩形的座標。

count

整數，指定 rects 陣列中的專案數目。

傳回值

如果方法成功，它會傳回 Ok，這是 Status 列舉的元素。

如果方法失敗，它會傳回 Status 列舉的其中一個其他元素。

備註

範例

下列範例會繪製一組矩形。

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);
}