CDC::MaskBlt

BOOL M&askBlt ( int x, int y, int nWidth, int nHeight, CDC * pSrcDC, int xSrc, int ySrc, CBitmapamp; maskBitmap, int xMask, int yMask, DWORD dwRop );

Valore restituito

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

Parametri

x

Specifica la logica coordinata x dell'angolo superiore sinistro del rettangolo di destinazione.

y

Specifica la logica coordinata y dell'angolo superiore sinistro del rettangolo di destinazione.

nWidth

Specifica la larghezza, in unità logiche, della bitmap rettangolo e origine destinazione.

nHeight

Specifica l'altezza, in unità logiche, della bitmap rettangolo e origine destinazione.

pSrcDC

Identifica il contesto di periferica da cui la bitmap deve essere copiato. Esso deve essere zero, se il parametro dwRop specifica un'operazione raster che non include una fonte.

xSrc

Specifica la logica coordinata x dell'angolo superiore sinistro dell'immagine bitmap di origine.

ySrc

Specifica la logica coordinata y dell'angolo superiore sinistro dell'immagine bitmap di origine.

maskBitmap

Identifica la bitmap maschera monocromatica, combinata con la bitmap di colore nel contesto di periferica fonte.

xMask

Specifica l'offset orizzontale pixel per la maschera bitmap specificata dal parametro maskBitmap.

yMask

Specifica l'offset di pixel verticali per la maschera bitmap specificata dal parametro maskBitmap.

dwRop

Specifica il primo piano e sfondo raster ternario operazione codici, che la funzione viene utilizzata per controllare la combinazione dei dati di origine e di destinazione. Il codice dell'operazione raster sfondo viene archiviato in alto byte della parola alta di questo valore; il codice dell'operazione raster in primo piano viene memorizzato nel byte basso della parola alta di questo valore; la parola bassa di questo valore viene ignorata e dovrebbe essere pari a zero. La macro MAKEROP4 crea tali combinazioni di primo piano e sfondo raster operazione codici. Vedere la sezione Osservazioni per una discussione di primo piano e sfondo nel contesto di questa funzione. Vedere la funzione membro BitBlt per un elenco dei codici comuni di operazione raster.

Osservazioni

Combina i dati relativi al colore per le bitmap di origine e di destinazione utilizzando il dato maschera e operazione raster. Il valore 1 nella maschera specificata da maskBitmap indica che il codice dell'operazione raster in primo piano specificato da dwRop deve essere applicato in quella posizione. Un valore pari a 0 nella maschera indica che il codice dell'operazione raster sfondo specificato da dwRop deve essere applicato in quella posizione. Se le operazioni raster richiedono una fonte, il rettangolo maschera deve coprire il rettangolo di origine. Se non lo fa, la funzione avrà esito negativo. Se le operazioni raster non necessitano di una fonte, il rettangolo maschera deve coprire il rettangolo di destinazione. Se non lo fa, la funzione fallirà.

Se una trasformazione di rotazione o di taglio è in vigore per il contesto di periferica di origine quando questa funzione viene chiamata, si verifica un errore. Tuttavia, altri tipi di trasformazioni sono ammessi.

Se i formati colore della sorgente, modello e destinazione bitmap differiscono, questa funzione converte il modello o il formato di origine o entrambi, per abbinare il formato di destinazione. Se la maschera bitmap non è una bitmap in bianco e nero, si verifica un errore. Quando un metafile avanzato è in fase di registrazione, si verifica un errore (e la funzione restituisce 0) se il contesto di periferica di origine identifica un contesto di periferica metafile avanzati. Non tutti i dispositivi supportano MaskBlt. Un'applicazione deve chiamare GetDeviceCaps per determinare se una periferica supporta questa funzione. Se non viene fornito nessun bitmap di maschera, questa funzione si comporta esattamente come BitBlt, utilizzando il codice di operazione raster in primo piano. Il pixel Sfalsa nella maschera bitmap mappa al punto (0,0) nella bitmap del contesto di periferica di origine. Questo è utile per i casi in cui una bitmap maschera contiene una serie di maschere; un'applicazione può facilmente applicare uno qualsiasi di essi a un'attività di trasferimento di maschera regolando l'offset di pixel e dimensioni del rettangolo inviati a MaskBlt.

CDC pa&noramica |nbsp; Membri della classe | Gerarchia Chart

Vedere anchenbsp;CDC::BitBlt, CDC::GetDeviceCaps, CDC::PlgBlt, CDC::StretchBlt, :: MaskBlt

Index