BOOL LoadBitmap ( LPCTSTR lpszResourceName );
BOOL LoadBitmap ( UINT nIDResource );
Valor de retorno
Diferente de zero se bem-sucedida; caso contrário 0.
Parâmetros
lpszResourceName
Aponta para uma seqüência de caracteres null-terminated que contém o nome do recurso de bitmap.
nIDResource
Especifica o número de identificação de recurso do recurso de bitmap.
Observações
Carrega o recurso de bitmap nomeado por lpszResourceName ou identificado pelo número de identificação em nIDResource do arquivo executável do aplicativo. O bitmap carregado é anexado para o objeto CBitmap.
Se o bitmap identificado por lpszResourceName não existe ou se há memória suficiente para carregar o bitmap, a função retorna 0.
Você pode usar a função de CGdiObject:: DeleteObject para excluir carregado pela função LoadBitmap bitmap, ou o destruidor CBitmap irá excluir o objeto para você.
! AVISO Antes de excluir o objeto, verifique se que ela não está selecionada em um contexto de dispositivo.
Os bitmaps seguintes foram adicionados para versões do Windows 3.1 e posteriores:
OBM_UPARRROWI
OBM_DNARROWI
OBM_RGARROWI
OBM_LFARROWI
Esses bitmaps não são encontradas em controladores 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 Referência do programador do Win32.
Visão geral de CBitmap | Membros de classe | Gráfico de hierarquia
Consulte tambémnbsp;CBitmap::LoadOEMBitmap, :: LoadBitmap, CGdiObject:: DeleteObject