CDC::StretchBlt

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

Valore restituito

Diverso da zero se la bitmap viene disegnata; in caso contrario 0.

Parametri

x

Specifica la coordinata x (in unità logiche) dell'angolo superiore sinistro del rettangolo di destinazione.

y

Specifica la coordinata y (in unità logiche) dell'angolo superiore sinistro del rettangolo di destinazione.

nWidth

Specifica la larghezza (in unità logico) del rettangolo di destinazione.

nHeight

Specifica l'altezza (in unità logico) del rettangolo di destinazione.

pSrcDC

Specifica il contesto di periferica di origine.

xSrc

Specifica la coordinata x (in unità logiche) dell'angolo superiore sinistro del rettangolo di origine.

ySrc

Specifica la coordinata x (in unità logiche) dell'angolo superiore sinistro del rettangolo di origine.

nSrcWidth

Specifica la larghezza (in unità logico) del rettangolo di origine.

nSrcHeight

Specifica l'altezza (in unità logico) del rettangolo di origine.

dwRop

Specifica l'operazione raster deve essere eseguito. Codici di operazione raster definire come GDI combina colori in operazioni di output che coinvolgono un pennello corrente, una bitmap di possibile origine e una bitmap di destinazione. Questo parametro può essere uno dei seguenti valori:

Osservazioni

Copia una bitmap da un rettangolo di origine in un rettangolo di destinazione, stretching o comprimendo la bitmap se necessario per adattare le dimensioni del rettangolo di destinazione. La funzione utilizza la modalità di allungamento del contesto di periferica di destinazione (musicato da SetStretchBltMode) per determinare come allungare o comprimere l'immagine bitmap.

La funzione StretchBlt si muove la bitmap dal dispositivo sorgente dato da pSrcDC al dispositivo di destinazione rappresentato dall'oggetto di contesto di periferica cui funzione membro viene chiamata. I parametri xSrc, ySrc, nSrcWidthe nSrcHeight definiscono l'angolo superiore sinistro e le dimensioni del rettangolo di origine. I parametri x, y, nWidth, nHeight e dare l'angolo superiore sinistro e le dimensioni del rettangolo di destinazione. L'operazione raster specificato da dwRop definisce come la bitmap di origine e i bit già sul dispositivo di destinazione vengono combinati.

La funzione StretchBlt crea un'immagine speculare di una bitmap se differiscono i segni dei parametri nSrcWidth e nWidth o nSrcHeight e nHeight . Se nSrcWidth e nWidth hanno diversi segni, la funzione crea un'immagine speculare della bitmap lungo l'asse x. Se nSrcHeight e nHeight hanno diversi segni, la funzione crea un'immagine speculare della bitmap lungo l'asse y.

La funzione StretchBlt si estende o comprime la bitmap di origine in memoria e quindi copia il risultato alla destinazione. Se un modello è fusa con il risultato, non è unita fino a quando la bitmap di origine allungata viene copiata alla destinazione. Se viene utilizzato un pennello, esso è il pennello selezionato nel contesto di periferica di destinazione. Le coordinate di destinazione vengono trasformate secondo per il contesto di periferica di destinazione; le coordinate di origine vengono trasformate secondo per il contesto di periferica di origine.

Se la destinazione, fonte e modello bitmap non hanno lo stesso formato di colore, StretchBlt converte le bitmap fonte e modello per abbinare le bitmap di destinazione. I colori di primo piano e sfondo del contesto di periferica di destinazione vengono utilizzati nella conversione.

Se StretchBlt deve convertire una bitmap in bianco e nero al colore, imposta per il colore di sfondo bianco bit (1) e nero bit (0) per il colore di primo piano. Per convertire il colore in bianco e nero, imposta pixel corrispondenti il colore di sfondo a bianco (1) e tutti gli altri pixel a nero (0). Vengono utilizzati i colori di primo piano e sfondo del contesto di periferica con colore.

Non tutti i dispositivi supportano la funzione StretchBlt . Per determinare se una periferica supporta StretchBlt, chiamare la funzione membro GetDeviceCaps con l'indice RASTERCAPS e controllare il valore restituito per il flag RC_STRETCHBLT.

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

Vedere anchenbsp;CDC::BitBlt, CDC::GetDeviceCaps, CDC::SetStretchBltMode, :: StretchBlt

Index