Função LoadMenuA (winuser.h)
Carrega o recurso de menu especificado do arquivo executável (.exe) associado a uma instância do aplicativo.
Sintaxe
HMENU LoadMenuA(
[in, optional] HINSTANCE hInstance,
[in] LPCSTR lpMenuName
);
Parâmetros
[in, optional] hInstance
Tipo: HINSTANCE
Um identificador para o módulo que contém o recurso de menu a ser carregado.
[in] lpMenuName
Tipo: LPCTSTR
O nome do recurso de menu. Como alternativa, esse parâmetro pode consistir no identificador de recurso na palavra de ordem baixa e zero na palavra de alta ordem. Para criar esse valor, use a macro
Valor de retorno
Tipo: HMENU
Se a função for bem-sucedida, o valor retornado será um identificador para o recurso de menu.
Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.
Observações
A função DestroyMenu é usada, antes do fechamento de um aplicativo, para destruir o menu e a memória livre ocupada pelo menu carregado.
Exemplos
Para obter um exemplo, consulte Exibindo um menu de atalho
Nota
O cabeçalho winuser.h define LoadMenu 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-menu-l1-1-3 (introduzido no Windows 10, versão 10.0.14393) |
Consulte também
Conceitual
de referência de