CDC::StretchBlt
Copia una bitmap da un rettangolo di origine in un rettangolo di destinazione, adattante o pacchetti la bitmap se necessario per adattare le dimensioni del rettangolo di destinazione.
BOOL StretchBlt(
int x,
int y,
int nWidth,
int nHeight,
CDC* pSrcDC,
int xSrc,
int ySrc,
int nSrcWidth,
int nSrcHeight,
DWORD dwRop
);
Parametri
x
Specifica la coordinata x (in unità logiche l'angolo superiore sinistro del rettangolo di destinazione.y
Specifica la coordinata y (in unità logiche l'angolo superiore sinistro del rettangolo di destinazione.nWidth
Specifica la larghezza (in unità logiche) del rettangolo di destinazione.nHeight
Specifica l'altezza (in unità logiche) del rettangolo di destinazione.pSrcDC
Specifica il contesto di dispositivo di origine.xSrc
Specifica la coordinata x (in unità logiche l'angolo superiore sinistro del rettangolo di origine.ySrc
Specifica la coordinata x (in unità logiche l'angolo superiore sinistro del rettangolo di origine.nSrcWidth
Specifica la larghezza (in unità logiche) del rettangolo di origine.nSrcHeight
Specifica l'altezza (in unità logiche) del rettangolo di origine.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.Questo parametro può essere uno dei seguenti valori:BLACKNESS disattiva il nero di output.
DSTINVERT inverte la bitmap di destinazione.
MERGECOPY combina il modello e la bitmap della risorsa utilizzando l'operatore AND booleano.
MERGEPAINT combina la bitmap della risorsa invertita con la bitmap di destinazione utilizzando l'operatore OR booleano.
NOTSRCCOPY copia la bitmap della risorsa invertita la destinazione.
NOTSRCERASE inverte il risultato della combinazione la destinazione e le bitmap di risorsa utilizzando l'operatore OR booleano.
PATCOPY copia il modello alla bitmap di destinazione.
PATINVERT combina la bitmap di destinazione con il modello mediante operatore booleano di XOR.
PATPAINT combina la bitmap della risorsa invertita con il modello utilizzando l'operatore OR booleano.Combina il risultato di questa operazione con la bitmap di destinazione utilizzando l'operatore OR booleano.
SRCAND combina i pixel di destinazione e le bitmap di risorsa utilizzando l'operatore AND booleano.
SRCCOPY copia la bitmap della risorsa la bitmap di destinazione.
SRCERASE inverte la bitmap di destinazione e combina il risultato con la bitmap della risorsa utilizzando l'operatore AND booleano.
SRCINVERT combina i pixel di destinazione e le bitmap di risorsa utilizzando un operatore booleano di XOR.
SRCPAINT combina i pixel di destinazione e le bitmap di risorsa utilizzando l'operatore OR booleano.
WHITENESS che tutto l'output bianco.
Valore restituito
Diverso da zero se la bitmap viene disegnata, in caso contrario 0.
Note
La funzione utilizza la modalità di estensione del contesto di dispositivo di destinazione (impostato da SetStretchBltMode) per determinare come estendere o comprimere la bitmap.
La funzione StretchBlt sposta la bitmap dal dispositivo di origine fornito da pSrcDC il dispositivo di destinazione rappresentato dall'oggetto di contesto di dispositivo in cui la funzione membro si sta chiamando.xSrc, ySrc, nSrcWidthe i parametri nSrcHeight definiscono l'angolo superiore sinistro e le dimensioni del rettangolo di origine.La x, y, nWidthe i parametri nHeight forniscono l'angolo superiore sinistro e le dimensioni del rettangolo di destinazione.L'operazione raster specificata da dwRop definisce come la bitmap della risorsa e i bit già nel dispositivo di destinazione vengono combinate.
La funzione StretchBlt crea un'immagine speculare di una bitmap se i segni nSrcWidth e nWidth o nSrcHeight e parametri nHeight differenze.Se nSrcWidth e nWidth contengono segni diversi, la funzione crea un'immagine speculare della bitmap lungo l'asse x.Se nSrcHeight e nHeight contengono segni diversi, la funzione crea un'immagine speculare della bitmap lungo l'asse y.
La funzione StretchBlt appropriata o comprimere la bitmap della risorsa in memoria e copia il risultato alla destinazione.Se un modello deve essere unito al risultato, non viene eseguito fino a copiando la bitmap della risorsa adatta alla destinazione.Se un pennello viene utilizzato, è il pennello selezionato nel contesto di dispositivo di destinazione.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 destinazione, l'origine e bitmap del modello non hanno lo stesso formato di colore, la conversione StretchBlt bitmap del modello e di origine corrispondenti alla destinazione è destinata a bit.Il primo piano e i colori di sfondo del contesto di dispositivo di destinazione vengono utilizzati nella conversione.
Se StretchBlt deve convertire 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.Per convertire il colore sull'impostazione monocromatica, a impostare i pixel corrispondenti al colore di sfondo bianco a (1) e imposta tutti gli altri pixel da nero (0).Il primo piano e i colori di sfondo del contesto di dispositivo con colori utilizzati.
Non tutti i controlli supportano la funzione StretchBlt.Per determinare se un dispositivo supporta StretchBlt, chiamare la funzione membro GetDeviceCaps con l'indice RASTERCAPS e controllare il valore restituito per il flag RC_STRETCHBLT.
Requisiti
Header: afxwin.h