Partilhar via


CBitmap::LoadBitmap

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

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

Parâmetros

  • lpszResourceName
    Aponta para uma cadeia de caracteres NULL- finalizada que contém o nome do recurso de bitmap.

  • nIDResource
    Especifica o número de identificação de recurso do recurso de bitmap.

Valor de retorno

Diferente de zero se com êxito; se não 0.

Comentários

o bitmap carregado é anexado ao objeto de CBitmap .

Se o bitmap identificado por lpszResourceName não existe ou se há uma insuficiente memória para carregar o bitmap, retorna 0 da função.

Você pode usar a função de CGdiObject::DeleteObject para excluir o bitmap carregado pela função de LoadBitmap , ou o destrutor de CBitmap excluirá o objeto para você.

Observação de cuidadoCuidado

Antes de excluir o objeto, certifique-se que não está selecionado em um contexto de dispositivo.

Os seguintes bitmaps foram adicionados às versões 3,1 e posterior do windows:

OBM_UPARRROWIOBM_DNARROWIOBM_RGARROWIOBM_LFARROWI

Esses bitmaps não são encontrados nos drivers de dispositivo para versões 3,0 e anteriores do windows.Para obter uma lista completa de bitmaps e uma exibição de sua aparência, consulte Windows SDK.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe de CBitmap

Gráfico de hierarquia

CBitmap::LoadOEMBitmap

LoadBitmap

CGdiObject::DeleteObject