CDC::Rectangle

Article
03/26/2013

Dessine un rectangle à l'aide de le stylet actuel.

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

Paramètres

x1
Spécifie la coordonnée x du coin supérieur gauche du rectangle (en unités logiques).
y1
Spécifie l'ordonnée du coin supérieur gauche du rectangle (en unités logiques).
x2
Spécifie la coordonnée x du coin inférieur droit du rectangle (en unités logiques).
y2
Spécifie l'ordonnée du coin inférieur droit du rectangle (en unités logiques).
lpRect
Spécifie le rectangle en unités logiques.Vous pouvez passer un objet d' CRect ou un pointeur vers une structure d' RECT pour ce paramètre.

Valeur de retour

Une valeur différente de zéro si la fonction est réussie ; sinon 0.

Notes

L'intérieur du rectangle est rempli à l'aide de le pinceau actuel.

Le rectangle s'étend jusqu'à, mais pas, la droite et les détails de bas.Cela signifie que la hauteur du rectangle est y2 – y1 et la largeur du rectangle est x2 – x1.La largeur et la hauteur d'un rectangle doivent être supérieures à 2 unités et moins de 32.767 unités.

Exemple

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