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

Artículo
08/24/2023

El método Graphics::D rawRectangles dibuja una secuencia de rectángulos.

Sintaxis

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

Parámetros

pen

Puntero a un lápiz que se usa para dibujar los rectángulos.

rects

Puntero a una matriz de objetos RectF que especifican las coordenadas de los rectángulos que se van a dibujar.

count

Entero que especifica el número de elementos de la matriz rects .

Valor devuelto

Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Observaciones

Ejemplos

En el ejemplo siguiente se dibuja un grupo de rectá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);
}