CDC::PlgBlt
Esegue un trasferimento di blocchi di bit di bit dei dati di colore dal rettangolo specificato nel contesto di dispositivo di origine al parallelogramma specificato nel contesto di dispositivo specificato.
BOOL PlgBlt(
LPPOINT lpPoint,
CDC* pSrcDC,
int xSrc,
int ySrc,
int nWidth,
int nHeight,
CBitmap& maskBitmap,
int xMask,
int yMask
);
Parametri
lpPoint
Punta a una matrice di tre punti nello spazio logico che identifica tre angoli del parallelogramma di destinazione.L'angolo superiore sinistro del rettangolo di origine è mappato al primo passaggio della matrice, all'angolo in alto a destra nel secondo passaggio della matrice eangolo inferiore sinistro al terzo punto.L'angolo inferiore destro del rettangolo di origine è mappato al quarto punto implicito nel parallelogramma.pSrcDC
Identifica il contesto di dispositivo di origine.xSrc
Specifica la coordinata x, in unità logiche, dell'angolo superiore sinistro del rettangolo di origine.ySrc
Specifica la coordinata y, in unità logiche, dell'angolo superiore sinistro del rettangolo di origine.nWidth
Specifica la larghezza, in unità logiche, il rettangolo di origine.nHeight
Specifica l'altezza, in unità logiche, il rettangolo di origine.maskBitmap
Identifica una bitmap facoltativa di monocromio utilizzata per l'impostazione i colori del rettangolo di origine.xMask
Specifica la coordinata x dell'angolo superiore sinistro della bitmap monocromatica.yMask
Specifica la coordinata y dell'angolo superiore sinistro della bitmap monocromatica.
Valore restituito
Diverso da zero se la funzione ha esito positivo; in caso contrario 0.
Note
Se l'handle specificato maschera di bit identificano una bitmap valida dell'impostazione monocromatica, alla funzione utilizza questa bitmap di mascherarle i bit dei dati di colore dal rettangolo di origine.
Il quarto vertice del parallelogramma (D) è definito considerare i primi tre punti (A, B e C) come vettori e calcolare D = B + C - Su.
Se la maschera di bit esiste, un valore 1 nella maschera indica che il colore di origine del pixel deve essere copiato nella destinazione.Un valore 0 nella maschera indica che il colore di destinazione del pixel non deve essere modificato.
Se il rettangolo della maschera è minore del database di origine e i rettangoli di destinazione, la funzione raggruppa il modello di maschera.
Il ridimensionamento, la conversione e le trasformazioni di reflection sono consentite nel contesto di dispositivo di origine; tuttavia, la rotazione e le trasformazioni di inclinazione non sono.Se la bitmap della maschera non è una bitmap monocromatica, si verifica un errore.La modalità di estensione del contesto di dispositivo di destinazione viene utilizzata per determinare come estendere o comprimere i pixel, se necessario.Quando un Enhanced Metafile sta registrando, viene generato un errore se il contesto di dispositivo di origine identifica un contesto di dispositivo di Enhanced Metafile.
Le coordinate di destinazione sono state trasformate in base al contesto di dispositivo di destinazione; le coordinate di origine sono state trasformate in base al contesto di dispositivo di origine.Se la trasformazione di origine è una rotazione o l'inclinazione, viene restituito un errore.Se la destinazione e rettangoli di origine non hanno lo stesso formato di colore, PlgBlt converte il rettangolo di origine in base al rettangolo di destinazione.Non tutti i controlli supportano PlgBlt.Per ulteriori informazioni, vedere la descrizione della funzionalità raster RC_BITBLT nella funzione membro CDC::GetDeviceCaps.
Se l'origine e i contesti di periferica di destinazione rappresentano dispositivi incompatibili, PlgBlt restituisce un errore.
Requisiti
Header: afxwin.h