CDC::retângulo

Artigo
08/25/2010

Desenha um retângulo usando a caneta corrente.

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

Parâmetros

x1
Especifica a coordenada x do canto superior esquerdo do retângulo (em unidades lógicas).
y1
Especifica a coordenada y do canto superior esquerdo do retângulo (em unidades lógicas).
x2
Especifica a coordenada x do canto inferior direito do retângulo (em unidades lógicas).
y2
Especifica a coordenada y do canto inferior direito do retângulo (em unidades lógicas).
lpRect
Especifica o retângulo em unidades lógicas.Você pode passar em um CRect objeto ou um ponteiro para um RECT estrutura para este parâmetro.

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário, 0.

Comentários

O interior do retângulo é preenchido usando o pincel corrente.

O retângulo estende até, mas não inclui as coordenadas direita e inferior.Isso significa que a altura do retângulo é y2 – y1 e a largura do retângulo é x2 – x1. A largura e a altura de um retângulo devem ser maior que 2 unidades e unidades menores que 32.767.

Exemplo

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