CBrush::CBrush

Artículo
06/10/2015

Crea un objeto CBrush.

CBrush( ); 
CBrush( 
   COLORREF crColor  
); 
CBrush( 
   int nIndex, 
   COLORREF crColor  
); 
explicit CBrush( 
   CBitmap* pBitmap  
);

Parámetros

crColor
Especifica el color de primer plano del pincel como color RGB. Si se trama el pincel, este parámetro especifica el color del tramado.
nIndex
Especifica el estilo de trama del pincel. Puede ser de los siguientes valores:
- Sombreado deHS_BDIAGONAL Downward (de izquierda a derecha) en 45 grados
- Sombreado doble horizontal y vertical deHS_CROSS
- Sombreado doble deHS_DIAGCROSS en 45 grados
- Sombreado deHS_FDIAGONAL Upward (de izquierda a derecha) en 45 grados
- Sombreado deHS_HORIZONTAL Horizontal
- Sombreado deHS_VERTICAL Vertical
pBitmap
Señala a un objeto de CBitmap que especifica un mapa de bits con el que el pincel pinta.

Comentarios

CBrush tiene cuatro constructores sobrecargados. El constructor sin argumentos construye un objeto sin inicializar de CBrush que debe inicializar antes de poderse utilizar.

Si utiliza el constructor sin argumentos, debe inicializar el objeto resultante de CBrush con CreateSolidBrush, CreateHatchBrush, CreateBrushIndirect, CreatePatternBrush, o CreateDIBPatternBrush. Si utiliza uno de los constructores que toma argumentos, no hay otra inicialización necesaria. Los constructores con los argumentos pueden producir una excepción si se encuentran errores, mientras que el constructor sin argumentos se realizará siempre correctamente.

El constructor con un único parámetro de COLORREF construye un pincel sólido con el color especificado. Color especifica un valor RGB y se pueden construir con la macro de RGB en WINDOWS.H.

El constructor con dos parámetros construye un pincel tramado. El parámetro de nIndex especifica el índice de un modelo tramado. El parámetro de crColor especifica el color.

El constructor con un parámetro de CBitmap construye un pincel modelado. el parámetro identifica un mapa de bits. El mapa de bits se supone que haya creado mediante CBitmap:: CreateBitmap, CBitmap:: CreateBitmapIndirect, CBitmap:: LoadBitmap, o CBitmap:: CreateCompatibleBitmap. El tamaño mínimo para que un mapa de bits se usará en una trama de relleno es 8 píxeles por 8 píxeles.

Ejemplo

// CBrush::CBrush.
CBrush brush1;   // Must initialize!
brush1.CreateSolidBrush(RGB(0, 0, 255));   // Blue brush.

CBrush* pTempBrush = NULL;
CBrush OrigBrush;

CRect rc;
GetClientRect(&rc);
ScreenToClient(&rc);

pTempBrush = (CBrush*)pDC->SelectObject(&brush1);
// Save original brush.
OrigBrush.FromHandle((HBRUSH)pTempBrush);

// Paint upper left corner with blue brush.
pDC->Rectangle(0, 0, rc.Width() / 2, rc.Height() / 2);

// These constructors throw resource exceptions. 
try
{
   // CBrush::CBrush(COLORREF crColor)
   CBrush brush2(RGB(255, 0, 0));   // Solid red brush. 

   // CBrush::CBrush(int nIndex, COLORREF crColor) 
   // Hatched green brush.
   CBrush brush3(HS_DIAGCROSS, RGB(0, 255, 0));

   // CBrush::CBrush(CBitmap* pBitmap)
   CBitmap bmp;
   // Load a resource bitmap.
   bmp.LoadBitmap(IDB_BRUSH);
   CBrush brush4(&bmp);

   pTempBrush = (CBrush*)pDC->SelectObject(&brush2);

   // Paint upper right corner with red brush.
   pDC->Rectangle(rc.Width() / 2, 0, rc.Width(),
   rc.Height() / 2);

   pTempBrush = (CBrush*)pDC->SelectObject(&brush3);

   // Paint lower left corner with green hatched brush.
   pDC->Rectangle(0, rc.Height() / 2, rc.Width() / 2,
   rc.Height());

   pTempBrush = (CBrush*)pDC->SelectObject(&brush4);

   // Paint lower right corner with resource brush.
   pDC->Rectangle(rc.Width() / 2, rc.Height() / 2,
      rc.Width(), rc.Height());
}
catch(CResourceException* e)
{
   e->ReportError();
   e->Delete();
}

// Reselect original brush into device context.
pDC->SelectObject(&OrigBrush);