CDC:: StretchBlt

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

Valor de retorno

Diferente de zero se o bitmap é desenhado; caso contrário 0.

Parâmetros

x

Especifica a coordenada x (em unidades lógicas) do canto superior esquerdo do retângulo de destino.

y

Especifica a coordenada y (nas unidades lógicas) do canto superior esquerdo do retângulo de destino.

nWidth

Especifica a largura (nas unidades lógicas) do Retangular de destino.

nHeight

Especifica a altura (em unidades lógicas) do Retangular de destino.

pSrcDC

Especifica o contexto de dispositivo de origem.

xSrc

Especifica a coordenada x (em unidades lógicas) do canto superior esquerdo do retângulo de origem.

ySrc

Especifica a coordenada x (em unidades lógicas) do canto superior esquerdo do retângulo de origem.

nSrcWidth

Especifica a largura (nas unidades lógicas) do Retangular de origem.

nSrcHeight

Especifica a altura (em unidades lógicas) do Retangular de origem.

dwRop

Especifica a operação de varredura a ser executada. Códigos operação de varredura definem como GDI combina cores nas operações de saída que envolvem um pincel atual, uma possível origem de bitmap e um bitmap de destino. Este parâmetro pode ser um dos seguintes valores:

Observações

Copia um bitmap de um retângulo origem para um retângulo destino, esticar ou compactação de bitmap se necessário para se ajustar às dimensões do retângulo de destino. A função usa o modo stretching do contexto de dispositivo de destino (definido por SetStretchBltMode) para determinar como alongar ou compactar o bitmap.

A função de StretchBlt move o bitmap de dispositivo de origem fornecido pelo pSrcDC para o dispositivo de destino representado pelo objeto dispositivo-contexto cuja função de membro está sendo chamada. XSrc, ySrc, nSrcWidthe nSrcHeight parâmetros definem o superior Esquerda canto e dimensões do Retangular de origem. Os x, y, nWidthe nHeight parâmetros dar superior-Esquerda canto e dimensões do Retangular de destino. O operação de varredura especificado por dwRop define como o bitmap de origem e os bits já no dispositivo de destino são combinados.

A função de StretchBlt cria uma imagem espelhada de um bitmap se os sinais da nSrcWidth e nWidth ou nSrcHeight e nHeight parâmetros forem diferentes. Se nSrcWidth e nWidth têm sinais diferentes, a função criará uma imagem espelhada do bitmap junto a eixo x. Se nSrcHeight e nHeight têm sinais diferentes, a função criará uma imagem espelhada do bitmap junto a eixo y.

A função de StretchBlt expande ou compacta o bitmap origem na memória e, em seguida, copia o resultado para o destino. Se um padrão a ser mesclado com o resultado, ele não será mesclado até que o bitmap de origem esticada é copiado para o destino. Se um pincel é usado, é o pincel selecionado no contexto de dispositivo de destino. As coordenadas de destino são transformadas de acordo com o contexto de dispositivo de destino; as coordenadas de origem são transformadas de acordo com o contexto de dispositivo de origem.

Se o destino, origem e bitmaps padrão não tiver o mesmo formato cor, StretchBlt converte os bitmaps de origem e o padrão para coincidir com os bitmaps de destino. As cores do primeiro plano e segundo plano do contexto de dispositivo de destino são usadas na conversão.

Se StretchBlt precisa converter um bitmap monocromático para cor, ele define branco bits (1) para a cor de fundo e bits preto (0) para a cor de primeiro plano. Para converter cores em monocromático, ele define pixels que correspondem a cor do plano de fundo para branco (1) e define todos os outros pixels para preto (0). As cores do primeiro plano e segundo plano do contexto para dispositivo com cor são usadas.

Nem todos os dispositivos suportam a função de StretchBlt . Para determinar se um dispositivo oferece suporte a StretchBlt, chamar a função de membro GetDeviceCaps com o índice RASTERCAPS e marcar o valor de retorno para o Sinalizar RC_STRETCHBLT.

Visão geral do CDCMembros de classe | Gráfico de hierarquia

Consulte tambémnbsp;CDC:: BitBlt, CDC:: GetDeviceCaps, CDC::SetStretchBltMode, :: StretchBlt

Index