CBrush::CreatePatternBrush

Articolo
03/05/2013

Inizializza un pennello a un modello specificato da una bitmap.

BOOL CreatePatternBrush(
   CBitmap* pBitmap 
);

Parametri

pBitmap
Identifica una bitmap.

Valore restituito

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

Note

Il pennello successivamente può essere selezionato per qualsiasi contesto di dispositivo tale operazioni raster supportate.La bitmap identificata da pBitmap in genere viene inizializzata utilizzando la funzione CBitmap::CreateBitmap, CBitmap::CreateBitmapIndirect, CBitmap::LoadBitmap, o CBitmap::CreateCompatibleBitmap.

Le immagini utilizzate come modelli di riempimento devono presentare dimensioni di 8 per 8 pixel.Se la bitmap è più grande, Windows utilizzerà solo i bit corrispondenti alle prime 8 righe e colonne di pixel nell'angolo superiore sinistro della bitmap.

Un pennello del modello può essere eliminato senza influire sulla bitmap collegata.Ciò significa che la bitmap può essere utilizzata per creare qualsiasi numero di pennelli del modello.

Un pennello creato utilizzando una bitmap monocromatica (1 piano di colori, 1 bit per pixel) viene tracciato utilizzando il testo e i colori di sfondo correnti.I pixel rappresentati da un bit impostato su 0 vengono disegnati con il colore del testo corrente.I pixel rappresentati da un bit impostato su 1 vengono disegnati con il colore di sfondo corrente.

Per informazioni su l CreatePatternBrush, una funzione Windows, vedere Windows SDK.

Esempio

// Create a hatched bit pattern.
WORD HatchBits[8] = { 0x11, 0x22, 0x44, 0x88, 0x11,
   0x22, 0x44, 0x88 };

// Use the bit pattern to create a bitmap.
CBitmap bm;
bm.CreateBitmap(8,8,1,1, HatchBits);

// Create a pattern brush from the bitmap.
CBrush brush;
brush.CreatePatternBrush(&bm);

// Select the brush into a device context, and draw.
CBrush* pOldBrush = (CBrush*)pDC->SelectObject(&brush);
pDC->RoundRect(CRect(50, 50, 200, 200), CPoint(10,10));

// Restore the original brush.
pDC->SelectObject(pOldBrush);