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 |
|---|---|
|
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. |
|
Exclui os pixels. Esse modo exclui todas as linhas de pixels eliminadas sem tentar preservar suas informações. |
|
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. |
|
O mesmo que BLACKONWHITE. |
|
O mesmo que COLORONCOLOR. |
|
O mesmo que HALFTONE. |
|
O mesmo que 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 |
|---|---|
|
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 |