CBrush::CBrush

Articolo
06/10/2015

Costruisce un oggetto CBrush.

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

Parametri

crColor
Specifica il colore di primo piano del pennello come colore RGB. Se il pennello è tratteggiato, questo parametro specifica il colore di tratteggio.
nIndex
Specifica lo stile del tratteggio del pennello. Può essere qualsiasi dei seguenti valori:
- Tratteggio discendente diHS_BDIAGONAL (da sinistra a destra) a 45 gradi
- DiHS_CROSS orizzontale e verticale crosshatch
- Crosshatch diHS_DIAGCROSS a 45 gradi
- Tratteggio dimensioni diHS_FDIAGONAL (da sinistra a destra) a 45 gradi
- Tratteggio orizzontale diHS_HORIZONTAL
- Tratteggio verticale diHS_VERTICAL
pBitmap
Punta a CBitmap oggetto che specifica una bitmap con cui il pennello disegna.

Note

CBrush dispone di quattro costruttori sottoposti a overload. Il costruttore senza argomenti costruisce un oggetto non inizializzata CBrush che deve essere inizializzato prima che possa essere utilizzato.

Se si utilizza il costruttore senza argomenti, è necessario inizializzare l'oggetto risultante CBrush con CreateSolidBrush, CreateHatchBrush, CreateBrushIndirect, CreatePatternBrush, o CreateDIBPatternBrush. Se si utilizza uno dei costruttori che accetta argomenti, non esiste alcuna ulteriore inizializzazione. I costruttori con gli argomenti possono generare un'eccezione in caso di errore, mentre il costruttore senza argomenti riuscirà sempre.

Il costruttore accetta un solo parametro COLORREF costruisce un oggetto solidbrush con il colore specificato. Il colore specificato un valore RGB e può essere costruito con la macro RGB in WINDOWS.H.

Il costruttore accetta due parametri viene costruito un pennello tratteggiato. Il parametro nIndex specifica l'indice di un modello tratteggiato. Il parametro crColor specifica il colore.

Il costruttore accetta un parametro CBitmap crea un pennello di. Il parametro identifica una bitmap. La bitmap costituisca creata utilizzando CBitmap::CreateBitmap, CBitmap::CreateBitmapIndirect, CBitmap::LoadBitmap, o CBitmap::CreateCompatibleBitmap. La dimensione minima di una bitmap venga utilizzata nel modello di riempimento è 8 pixel da 8 pixel.

Esempio

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