CBitmap::LoadBitmap

Artigo
08/25/2010

Carrega o recurso de bitmap chamado por lpszResourceName ou identificado pelo número de ID nIDResource do arquivo executável do aplicativo.

BOOL LoadBitmap(
   LPCTSTR lpszResourceName 
);
BOOL LoadBitmap(
   UINT nIDResource 
);

Parâmetros

lpszResourceName
Aponta para uma seqüência de caracteres terminada com nulo que contém o nome do recurso de bitmap.
nIDResource
Especifica o número de ID de recurso do recurso de bitmap.

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário, 0.

Comentários

O bitmap carregado está associado a CBitmap objeto.

Se o bitmap é identificado por lpszResourceName não existe ou se não há memória suficiente para carregar o bitmap, a função retornará 0.

Você pode usar o CGdiObject::DeleteObject função para excluir bitmap carregado pelo LoadBitmap função, ou o CBitmap Destrutor excluirá o objeto para você.

Cuidado:
Antes de excluir o objeto, verifique se não estiver em um contexto de dispositivo.

Os bitmaps seguintes foram adicionados para versões do Windows 3.1 e posteriores:

OBM_UPARRROWIOBM_DNARROWIOBM_RGARROWIOBM_LFARROWI

Esses bitmaps não encontrados em drivers de dispositivo para Windows versões 3.0 e anteriores.Para obter uma lista completa de bitmaps e uma exibição de sua aparência, consulte o Windows SDK.