Função GetStretchBltMode (wingdi.h)

A função GetStretchBltMode recupera o modo de alongamento atual. O modo de alongamento define como os dados de cor são adicionados ou removidos de bitmaps que são estendidos ou compactados quando a função StretchBlt é chamada.

Sintaxe

int GetStretchBltMode(
  [in] HDC hdc
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

Retornar valor

Se a função for bem-sucedida, o valor retornado será o modo de alongamento atual. Esse pode ser um dos valores a seguir.

Valor	Descrição
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.
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 BOOLEAN OR 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.

 

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

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

Confira também

Funções de bitmap

Visão geral do Bitmaps

SetStretchBltMode