Função SetStretchBltMode (wingdi.h)

A função SetStretchBltMode define o modo de alongamento de bitmap no contexto do dispositivo especificado.

Sintaxe

int SetStretchBltMode(
  [in] HDC hdc,
  [in] int mode
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] mode

O modo de alongamento. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
BLACKONWHITE	Executa uma operação AND booliana usando os valores de cor para os pixels eliminados e existentes. Se o bitmap for um bitmap monocromático, esse modo preservará pixels pretos em detrimento de pixels brancos.
COLORONCOLOR	Exclui os pixels. Esse modo exclui todas as linhas de pixels eliminadas sem tentar preservar suas informações.
HALFTONE	Mapeia pixels do retângulo de origem em blocos de pixels no retângulo de destino. A cor média sobre o bloco de destino de pixels aproxima a cor dos pixels de origem. Depois de definir o modo de alongamento HALFTONE, um aplicativo deve chamar a função SetBrushOrgEx para definir a origem do pincel. Se ele não fizer isso, ocorrerá desalinhamento de pincel.
STRETCH_ANDSCANS	O mesmo que BLACKONWHITE.
STRETCH_DELETESCANS	O mesmo que COLORONCOLOR.
STRETCH_HALFTONE	O mesmo que HALFTONE.
STRETCH_ORSCANS	O mesmo que WHITEONBLACK.
WHITEONBLACK	Executa uma operação OR booliana usando os valores de cor para os pixels eliminados e existentes. Se o bitmap for um bitmap monocromático, esse modo preservará pixels brancos em detrimento de pixels pretos.

Retornar valor

Se a função for bem-sucedida, o valor retornado será o modo de alongamento anterior.

Se a função falhar, o valor retornado será zero.

Essa função pode retornar o valor a seguir.

Código de retorno	Descrição
ERROR_INVALID_PARAMETER	Um ou mais dos parâmetros de entrada são inválidos.

Comentários

O modo de alongamento define como o sistema combina linhas ou colunas de um bitmap com pixels existentes em um dispositivo de exibição quando um aplicativo chama a função StretchBlt .

Os modos BLACKONWHITE (STRETCH_ANDSCANS) e WHITEONBLACK (STRETCH_ORSCANS) normalmente são usados para preservar pixels de primeiro plano em bitmaps monocromáticos. O modo COLORONCOLOR (STRETCH_DELETESCANS) normalmente é usado para preservar a cor em bitmaps de cor.

O modo HALFTONE é mais lento e requer mais processamento da imagem de origem do que os outros três modos; mas produz imagens de maior qualidade. Observe também que SetBrushOrgEx deve ser chamado depois de definir o modo HALFTONE para evitar o desalinhamento do pincel.

Modos de alongamento adicionais também podem estar disponíveis dependendo dos recursos do driver do dispositivo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll