Método Graphics::D rawRectangles(constPen,constRectF,INT) (gdiplusgraphics.h)

Artigo
03/16/2023

O método Graphics::D rawRectangles desenha uma sequência de retângulos.

Sintaxe

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

Parâmetros

pen

Ponteiro para uma Caneta usada para desenhar os retângulos.

rects

Ponteiro para uma matriz de objetos RectF que especificam as coordenadas dos retângulos a serem desenhados.

count

Inteiro que especifica o número de elementos na matriz de rects .

Valor retornado

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Exemplos

O exemplo a seguir desenha um grupo de retângulos.

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