CDC::Rectangle

Artículo
04/10/2013

Dibuja un rectángulo utilizando el lápiz actual.

BOOL Rectangle(
   int x1,
   int y1,
   int x2,
   int y2 
);
BOOL Rectangle(
   LPCRECT lpRect 
);

Parámetros

x1
Especifica la coordenada x de la esquina superior izquierda del rectángulo (en unidades lógicas).
y1
Especifica la coordenada y de la esquina superior izquierda del rectángulo (en unidades lógicas).
x2
Especifica la coordenada x de la esquina inferior derecha del rectángulo (en unidades lógicas).
y2
Especifica la coordenada y de la esquina inferior derecha del rectángulo (en unidades lógicas).
lpRect
Especifica el rectángulo en unidades lógicas.Puede pasar un objeto de CRect o un puntero a una estructura de RECT para este parámetro.

Valor devuelto

Distinto de cero si la función es correcta; si no 0.

Comentarios

El interior del rectángulo se rellena mediante el pincel actual.

El rectángulo se extiende hasta, pero no incluye, derecho y las coordenadas de la parte inferior.Esto significa que el alto del rectángulo se y2 – y1 y el ancho del rectángulo se x2 – x1.El ancho y alto de un rectángulo deben ser mayores que 2 unidades y menos de 32.767 unidades.

Ejemplo

void CDCView::DrawRectangle(CDC* pDC)
{
   // create and select a solid blue brush
   CBrush brushBlue(RGB(0, 0, 255));
   CBrush* pOldBrush = pDC->SelectObject(&brushBlue);

   // create and select a thick, black pen
   CPen penBlack;
   penBlack.CreatePen(PS_SOLID, 3, RGB(0, 0, 0));
   CPen* pOldPen = pDC->SelectObject(&penBlack);

   // get our client rectangle
   CRect rect;
   GetClientRect(rect);

   // shrink our rect 20 pixels in each direction
   rect.DeflateRect(20, 20);

   // draw a thick black rectangle filled with blue
   pDC->Rectangle(rect);

   // put back the old objects
   pDC->SelectObject(pOldBrush);
   pDC->SelectObject(pOldPen);
}