CDC::Rectangle

Articolo
06/10/2015

Consente di disegnare un rettangolo utilizzando la penna corrente.

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

Parametri

x1
Specifica la coordinata x dell'angolo superiore sinistro del rettangolo (in unità logiche).
y1
Specifica la coordinata y dell'angolo superiore sinistro del rettangolo (in unità logiche).
x2
Specifica la coordinata x l'angolo inferiore destro del rettangolo (in unità logiche).
y2
Specifica la coordinata y l'angolo inferiore destro del rettangolo (in unità logiche).
lpRect
Consente di specificare il rettangolo in unità logiche. È possibile passare un oggetto CRect o un puntatore a una struttura RECT per questo parametro.

Valore restituito

Diverso da zero se la funzione ha esito positivo; in caso contrario 0.

Note

L'interno del rettangolo viene riempito con il pennello corrente.

Il rettangolo si estende fino a, ma non include, la destra e le coordinate del basso. Ciò significa che l'altezza del rettangolo è y2 – y1 e la larghezza del rettangolo è x2 – x1. La larghezza e l'altezza di un rettangolo devono essere maggiori di 2 unità e meno di 32.767 unità.

Esempio

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