Compartilhar via


Função LoadMenuIndirectA (winuser.h)

Carrega o modelo de menu especificado na memória.

Sintaxe

HMENU LoadMenuIndirectA(
  [in] const MENUTEMPLATEA *lpMenuTemplate
);

Parâmetros

[in] lpMenuTemplate

Tipo: const MENUTEMPLATE*

Um ponteiro para um modelo de menu ou um modelo de menu estendido. Um modelo de menu consiste em uma estrutura MENUITEMTEMPLATEHEADER seguida por uma ou mais estruturas de MENUITEMTEMPLATE contíguas. Um modelo de menu estendido consiste em uma estrutura MENUEX_TEMPLATE_HEADER seguida por uma ou mais estruturas de MENUEX_TEMPLATE_ITEM contíguas.

Valor de retorno

Tipo: HMENU

Se a função for bem-sucedida, o valor retornado será um identificador para o menu.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Observações

Para o ANSI e a versão Unicode dessa função, as cadeias de caracteres na estrutura MENUITEMTEMPLATE devem ser cadeias de caracteres Unicode.

Nota

O cabeçalho winuser.h define LoadMenuIndirect como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de 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

Consulte também

Conceitual

LoadMenu

MENUEX_TEMPLATE_HEADER

MENUEX_TEMPLATE_ITEM

MENUITEMTEMPLATE

MENUITEMTEMPLATEHEADER

menus

de referência de