CDC::Rectangle

Artykuł
02/27/2013

Rysuje prostokąt przy użyciu bieżącego pióra.

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

Parametry

x1
Określa współrzędną x lewego górnego rogu prostokąta (w jednostkach logicznych).
y1
Określa współrzędną y lewego górnego rogu prostokąta (w jednostkach logicznych).
x2
Określa współrzędną x w prawym dolnym rogu prostokąta (w jednostkach logicznych).
y2
Określa współrzędną y dolnym rogu prostokąta (w jednostkach logicznych).
lpRect
Określa prostokąt w jednostkach logicznych.Można przekazywać albo CRect lub wskaźnik do obiektu RECT struktury dla tego parametru.

Wartość zwracana

Niezerowa, jeśli funkcja jest pomyślne; 0 inaczej.

Uwagi

Wewnątrz prostokąta jest wypełniane przy użyciu aktualnego pędzla.

Prostokąt rozciąga się do, ale nie zawiera współrzędne prawej i dolnej.Oznacza to, że wysokość prostokąta jest y2 — y1 i szerokość prostokąta jest x2 — x1.Szerokość i wysokość prostokąta musi być większa niż 2 i jednostek mniej niż 32 767.

Przykład

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