StretchBlt

9/9/2008

Esta função copia um bitmap de um retângulo origem para um retângulo destino, esticar ou compactação de bitmap para se ajustar às dimensões do retângulo de destino, se necessário. Expande ou compacta o bitmap Windows de acordo com o modo alongamento definir no contexto dispositivo de destino.

Syntax

BOOL StretchBlt(
  HDC hdcDest, 
  int nXOriginDest, 
  int nYOriginDest, 
  int nWidthDest, 
  int nHeightDest, 
  HDC hdcSrc, 
  int nXOriginSrc, 
  int nYOriginSrc, 
  int nWidthSrc, 
  int nHeightSrc, 
  DWORD dwRop
); 

Parameters

• hdcDest
  [no] Identificador para o contexto dispositivo destino.

• nXOriginDest
  [no] Especifica o x-coordenar, em unidades lógicas, do canto superior esquerdo do retângulo de destino.

• nYOriginDest
  [no] Especifica a y-coordenar, em unidades lógicas, do canto superior esquerdo do retângulo de destino.

• nWidthDest
  [no] Especifica a largura, em unidades lógicas, do retângulo de destino.

• nHeightDest
  [no] Especifica a altura, em unidades lógicas, do retângulo de destino.

• hdcSrc
  [no] Identificador para o contexto dispositivo origem.

• nXOriginSrc
  [no] Especifica o x-coordenar, em unidades lógicas, do canto superior esquerdo do retângulo de origem.

• nYOriginSrc
  [no] Especifica a y-coordenar, em unidades lógicas, do canto superior esquerdo do retângulo de origem.

• nWidthSrc
  [no] Especifica a largura, em unidades lógicas, do retângulo de origem.

• nHeightSrc
  [no] Especifica a altura, em unidades lógicas, do retângulo de origem.

• dwRop
  [no] Especifica o operação de varredura para ser realizado.

  Varredura operação códigos definem como o sistema combina cores na saída operações que envolvem um pincel, um bitmap origem e um bitmap destino.

  Consulte BitBlt Para uma lista de comum códigos operação de varredura.

  Para o lista completa dos códigos de operações de varredura, consulte Operações de varredura ternários.

  Windows CE 1.0 e 1.01 suporte somente a SRCCOPY e SRCINVERT Operações de varredura.

Return Value

Nonzero indica sucesso.

Zero indica falha.

Para informações de erro estendidas get, chamar GetLastError.

Remarks

StretchBlt Expande ou compacta o bitmap origem na memória e, em seguida, copia o resultado para retângulo de destino. Os dados cor para pixels padrão ou destino são mesclados após o alongamento ou compactação ocorre.

Quando um metarquivo avançado está sendo gravada, ocorrerá um erro (e a função retorna FALSE) se o contexto dispositivo origem identifica um avançado-contexto dispositivo metarquivo.

Se o operação de varredura especificado requer um pincel, o sistema usa o pincel selecionado no momento no contexto dispositivo de destino.

Coordenadas de destino são transformadas usando a transformação especificada no momento para contexto para dispositivo de destino; coordenadas de origem são transformadas usando a transformação especificada no momento para o contexto dispositivo origem.

Se a transformação origem tiver uma rotação ou distorcer, ocorrerá um erro.

Se destino, origem e bitmaps padrão não tiver o mesmo formato cor, StretchBlt Converte os bitmaps origem e padrão para coincidir com o bitmap destino.

Se StretchBlt Precisa converter um bitmap monocromático para um bitmap cor, ele define bits em branco (1) para o cor do plano de fundo e preto bits (0) para a cor primeiro plano.

Para converter um bitmap cor a um bitmap 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 primeiro plano e segundo plano do contexto para dispositivo com cor são usadas.

StretchBlt Cria uma imagem espelhada de um bitmap se os sinais da nWidthSrc e nWidthDest Parâmetros ou a nHeightSrc e nHeightDest Os parâmetros são diferentes.

Se nWidthSrc e nWidthDest têm sinais diferentes, a função cria uma imagem espelhada do bitmap junto a eixo x.

Se nHeightSrc e nHeightDest têm sinais diferentes, a função cria uma imagem espelhada do bitmap junto a eixo y.

Windows CE 1.0 e 1.01 não suporte espelhamento.

Nem todos os dispositivos suporte a StretchBlt função. Para obter mais informações, consulte o GetDeviceCaps.

Se hDC Especifica um contexto dispositivo espelhado, o aumento coordenadas horizontal de direita para a esquerda rather than de esquerda para a direita.

Para obter informações sobre como blitting para exibe com right-to-left orientações, consulte Criando os bitmaps.

Requirements

Header	windows.h
Library	coredll.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

BitBlt
GetDeviceCaps
MaskBlt
GDI Functions
Ternary Raster Operations