CDC::StretchBlt

Artigo
08/25/2010

Copia um bitmap de um Retangular de origem para um Retangular de destino, alongamento ou compactação de bitmap se necessário para se ajustar às dimensões do Retangular de destino.

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

Parâmetros

x
Especifica a coordenada x (em unidades lógicas) do canto superior Esquerda canto do Retangular de destino.
y
Especifica a coordenada y (nas unidades lógicas) do canto superior Esquerda canto do Retangular 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 Esquerda canto do Retangular de origem.
ySrc
Especifica a coordenada x (em unidades lógicas) do canto superior Esquerda canto do Retangular 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 de operação de varredura definir como GDI combina cores em operações de saída que envolvem um pincel atual, um bitmap de origem possíveis e um bitmap de destino.Esse parâmetro pode ser um dos seguintes valores:
- BLACKNESS fica que Tudo as saída preto.
- DSTINVERT inverte o bitmap de destino.
- MERGECOPY combina o padrão e o bitmap de origem usando o operador E Booleano.
- MERGEPAINT combina o bitmap de origem invertido com o destino de bitmap usando o operador ou booleano.
- Cópias de NOTSRCCOPY a Origem invertida bitmap para o destino.
- NOTSRCERASE inverte o resultado de combinar os bitmaps de destino e origem usando o operador ou booleano.
- PATCOPY copia o padrão para o bitmap de destino.
- PATINVERT combina o destino de bitmap com o padrão usando o operador XOR Booleano.
- PATPAINT combina a Origem invertida bitmap com o padrão usando o operador ou booleano.Combina o resultado desta operação com o bitmap de destino usando o operador ou booleano.
- SRCAND combina pixels, dos bitmaps de destino e origem usando o operador E Booleano.
- Cópias de SRCCOPY a Origem de bitmap para o bitmap de destino.
- SRCERASE inverte o bitmap de destino e combina o resultado com o bitmap de origem usando o operador E Booleano.
- SRCINVERT combina pixels, dos bitmaps de destino e origem usando o operador XOR Booleano.
- SRCPAINT combina pixels, dos bitmaps de destino e origem usando o operador ou booleano.
- WHITENESS fica que Tudo as saída em branco.

Valor de retorno

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

Comentários

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 StretchBlt move o bitmap do dispositivo de origem fornecido pelo pSrcDC ao dispositivo de destino representado pelo objeto contexto de dispositivo cuja função de membro está sendo chamada.O xSrc, ySrc, nSrcWidthe nSrcHeight parâmetros Definirm o superior Esquerda canto e dimensões do Retangular de origem.O x, y, nWidthe nHeight parâmetros dar superior-Esquerda canto e dimensões do Retangular de destino.A operação de varredura especificada 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 de 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 ao longo do eixo x.Se nSrcHeight e nHeight têm sinais diferentes, a função criará uma imagem espelhada do bitmap ao longo do eixo y.

A função StretchBlt expande ou compacta o bitmap de origem na memória e copiará 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 esticadas é copiado para o destino.Se um pincel for usado, é o Pincel selecionado no contexto de dispositivo de destino.As coordenadas de destino são transformadas de acordo com para 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 têm o mesmo Formatarar de cor, StretchBlt converte os bitmaps de origem e o padrão para coincidir com os bitmaps de destino.As cores de primeiro plano e plano de fundo do contexto de dispositivo de destino são usadas na conversão.

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

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