CDC::BitBlt

Articolo
03/05/2013

Copia una bitmap dal contesto di dispositivo di origine al contesto di dispositivo corrente.

BOOL BitBlt(
   int x,
   int y,
   int nWidth,
   int nHeight,
   CDC* pSrcDC,
   int xSrc,
   int ySrc,
   DWORD dwRop 
);

Parametri

x
Specifica la coordinata x logica dell'angolo superiore sinistro del rettangolo di destinazione.
y
Specifica la coordinata y logica dell'angolo superiore sinistro del rettangolo di destinazione.
nWidth
Specifica la larghezza (in unità logiche) del rettangolo di destinazione e bitmap di risorsa.
nHeight
Specifica l'altezza (in unità logiche) del rettangolo di destinazione e bitmap di risorsa.
pSrcDC
Puntatore a un oggetto CDC che identifica il contesto di dispositivo che la bitmap verrà copiata.Deve essere NULL se il dwRop specifica un'operazione raster che non include un database di origine.
xSrc
Specifica la coordinata x logica dell'angolo superiore sinistro della bitmap della risorsa.
ySrc
Specifica la coordinata y logica dell'angolo superiore sinistro della bitmap della risorsa.
dwRop
Specifica l'operazione raster da eseguire.I codici di un'operazione raster definiscono come GDI combina i colori nelle operazioni di output che includono un pennello corrente, una bitmap di risorsa possibile e una bitmap di destinazione.Vedere BitBlt in Windows SDK per un elenco dei codici di un'operazione raster per dwRop e le relative descrizioni

Per un elenco completo dei codici di un'operazione raster, vedere Sui codici di un'operazione raster in Windows SDK.

Valore restituito

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

Note

È possibile allineare le finestre o le aree client nei limiti di byte per assicurare che le operazioni BitBlt si verifichino i rettangoli byte- allineati.(Impostare i flag CS_BYTEALIGNCLIENT o CS_BYTEALIGNWINDOW quando si registra le classi di finestre.)

Le operazioni diBitBlt sui rettangoli byte- allineati sono molto più veloci delle operazioni BitBlt sui rettangoli che non sono byte allineato.Se si desidera specificare gli stili della classe come allineamento di byte dal proprio contesto di dispositivo, sarà necessario registrare una classe window anziché basarsi sulle classi MFC (Microsoft Foundation per farvi automaticamente.Utilizzare la funzione globale AfxRegisterWndClass.

GDI trasforma nWidth e nHeight, una volta utilizzando il contesto di dispositivo di destinazione e una volta utilizzando il contesto di dispositivo di origine.Se gli ambiti risultante non corrispondono, GDI utilizza la funzione di Windows StretchBlt per comprimere in base alle esigenze o ingrandire la bitmap della risorsa.

Se la destinazione, l'origine e bitmap del modello non hanno lo stesso formato di colore, la conversione di funzione BitBlt il database di origine e bitmap del modello da corrispondere alla destinazione.Il primo piano e i colori di sfondo bitmap di destinazione vengono utilizzati nella conversione.

Quando la funzione BitBlt converte una bitmap monocromatica per colorare, impostare i bit bianche (1) ai bit del nero e del colore di sfondo (0) al colore di primo piano.Il primo piano e i colori di sfondo del contesto di dispositivo di destinazione vengono utilizzati.Per convertire colore sull'impostazione monocromatica, a pixel di set BitBlt corrispondenti al colore di sfondo bianco e sugli insiemi tutti gli altri pixel in nero.Utilizza ilBitBlt i colori di primo piano e di sfondo del contesto di dispositivo di colore per la conversione da colore a monocromio.

Si noti che non tutti i contesti di periferica supportano BitBlt.Per verificare se un contesto di dispositivo specificato supporta BitBlt, utilizzare la funzione membro GetDeviceCaps e specificare l'indice RASTERCAPS.