Função CreateDiscardableBitmap (wingdi.h)

A função CreateDiscardableBitmap cria um bitmap descartado compatível com o dispositivo especificado. O bitmap tem o mesmo formato bits por pixel e a mesma paleta de cores que o dispositivo. Um aplicativo pode selecionar esse bitmap como o bitmap atual para um dispositivo de memória compatível com o dispositivo especificado.

Nota Essa função é fornecida apenas para compatibilidade com versões de 16 bits do Windows. Os aplicativos devem usar a função CreateCompatibleBitmap .

 

Sintaxe

HBITMAP CreateDiscardableBitmap(
  [in] HDC hdc,
  [in] int cx,
  [in] int cy
);

Parâmetros

[in] hdc

Um identificador para um contexto de dispositivo.

[in] cx

A largura, em pixels, do bitmap.

[in] cy

A altura, em pixels, do bitmap.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um identificador para o DDB (bitmap) compatível.

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

Comentários

Quando você não precisar mais do bitmap, chame a função DeleteObject para excluí-lo.

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

Confira também

Funções de bitmap

Visão geral do Bitmaps

Createcompatiblebitmap

DeleteObject