Função SetBitmapDimensionEx (wingdi.h)

Artigo
03/08/2023

A função SetBitmapDimensionEx atribui dimensões preferenciais a um bitmap. Essas dimensões podem ser usadas por aplicativos; no entanto, eles não são usados pelo sistema.

Sintaxe

BOOL SetBitmapDimensionEx(
  [in]  HBITMAP hbm,
  [in]  int     w,
  [in]  int     h,
  [out] LPSIZE  lpsz
);

Parâmetros

[in] hbm

Um identificador para o bitmap. O bitmap não pode ser um bitmap da seção DIB.

[in] w

A largura, em unidades de 0,1 milímetro, do bitmap.

[in] h

A altura, em unidades de 0,1 milímetro, do bitmap.

[out] lpsz

Um ponteiro para uma estrutura SIZE para receber as dimensões anteriores do bitmap. Esse ponteiro pode ser NULL.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

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

Comentários

Um aplicativo pode recuperar as dimensões atribuídas a um bitmap com a função SetBitmapDimensionEx chamando a função GetBitmapDimensionEx .

O bitmap identificado por hBitmap não pode ser uma seção DIB, que é um bitmap criado pela função CreateDIBSection . Se o bitmap for uma seção DIB, a função SetBitmapDimensionEx falhará.

Requisitos


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