CDC::Rectangle

Artikel
06/10/2015

Zeichnet ein Rechteck unter Verwendung des aktuellen Stiftes.

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

Parameter

x1
Gibt die X-Koordinate der oberen linken Ecke des Rechtecks an (in logischen Einheiten).
y1
Gibt die Y-Koordinate der oberen linken Ecke des Rechtecks an (in logischen Einheiten).
x2
Gibt die X-Koordinate der rechten unteren Ecke des Rechtecks an (in logischen Einheiten).
y2
Gibt die Y-Koordinate der unteren rechten Ecke des Rechtecks an (in logischen Einheiten).
lpRect
Gibt das Rechteck in logischen Einheiten an. Sie können entweder ein CRect-Objekt oder einen Zeiger auf eine Struktur RECT für diesen Parameter übergeben.

Rückgabewert

Ungleich 0 (null), wenn die Funktion erfolgreich; 0 andernfalls.

Hinweise

Der Innere des Rechtecks wird unter Verwendung des aktuellen Pinselfarbe gefüllt.

Das Rechteck erstreckt sich bis enthalten, jedoch nicht, die NACH-RECHTS- und Unterseitenkoordinaten. Dies bedeutet, dass die Höhe des Rechtecks y2 - y1 und die Breite des Rechtecks ist x2 - x1 ist. müssen die Breite und Höhe eines Rechtecks als 2 Einheiten und weniger als 32.767 Einheiten größer sein.

Beispiel

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