Função LoadBitmapA (winuser.h)
[LoadBitmap está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes. Em vez disso, use LoadImage e DrawFrameControl.]
A função LoadBitmap carrega o recurso de bitmap especificado do arquivo executável de um módulo.
Sintaxe
HBITMAP LoadBitmapA(
[in] HINSTANCE hInstance,
[in] LPCSTR lpBitmapName
);
Parâmetros
[in] hInstance
Um identificador para a instância do módulo cujo arquivo executável contém o bitmap a ser carregado.
[in] lpBitmapName
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do recurso bitmap a ser carregado. Como alternativa, esse parâmetro pode consistir no identificador de recurso na palavra de ordem baixa e zero na palavra de alta ordem. A macro
Valor de retorno
Se a função for bem-sucedida, o valor retornado será o identificador para o bitmap especificado.
Se a função falhar, o valor retornado será NULL.
Observações
Se o bitmap apontado pelo parâmetro lpBitmapName não existir ou não houver memória suficiente para carregar o bitmap, a função falhará.
LoadBitmap cria um bitmap compatível da exibição, que não pode ser selecionado para uma impressora. Para carregar um bitmap que você pode selecionar para uma impressora, chame loadimage e especifique LR_CREATEDIBSECTION para criar uma seção DIB. Uma seção DIB pode ser selecionada em qualquer dispositivo.
Um aplicativo pode usar a função LoadBitmap para acessar bitmaps predefinidos. Para fazer isso, o aplicativo deve definir o parâmetro hInstance para NULL e o parâmetro lpBitmapName como um dos valores a seguir.
| Nome do bitmap | Nome do bitmap |
|---|---|
| OBM_BTNCORNERS | OBM_OLD_RESTORE |
| OBM_BTSIZE | OBM_OLD_RGARROW |
| OBM_CHECK | OBM_OLD_UPARROW |
| OBM_CHECKBOXES | OBM_OLD_ZOOM |
| OBM_CLOSE | OBM_REDUCE |
| OBM_COMBO | OBM_REDUCED |
| OBM_DNARROW | OBM_RESTORE |
| OBM_DNARROWD | OBM_RESTORED |
| OBM_DNARROWI | OBM_RGARROW |
| OBM_LFARROW | OBM_RGARROWD |
| OBM_LFARROWD | OBM_RGARROWI |
| OBM_LFARROWI | OBM_SIZE |
| OBM_MNARROW | OBM_UPARROW |
| OBM_OLD_CLOSE | OBM_UPARROWD |
| OBM_OLD_DNARROW | OBM_UPARROWI |
| OBM_OLD_LFARROW | OBM_ZOOM |
| OBM_OLD_REDUCE | OBM_ZOOMD |
Os nomes de bitmap que começam com OBM_OLD representam bitmaps usados por versões de 16 bits do Windows anteriores à 3.0.
Para que um aplicativo use qualquer uma das constantes OBM_, a constante OEMRESOURCE deve ser definida antes que o arquivo de cabeçalho Windows.h seja incluído.
O aplicativo deve chamar a função
Exemplos
Para obter um exemplo, consulte Exemplo de bitmaps Menu-Item em usando menus.
Nota
O cabeçalho winuser.h define LoadBitmap como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winuser.h (inclua Windows.h) |
| biblioteca | User32.lib |
| de DLL |
User32.dll |
| conjunto de API | ext-ms-win-ntuser-draw-l1-1-1 (introduzido no Windows 8.1) |
Consulte também
Visão geral do Bitmaps
loadicon