Função GetMenuItemInfoW (winuser.h)

Recupera informações sobre um item de menu.

Sintaxe

BOOL GetMenuItemInfoW(
  [in]      HMENU           hmenu,
  [in]      UINT            item,
  [in]      BOOL            fByPosition,
  [in, out] LPMENUITEMINFOW lpmii
);

Parameters

[in] hmenu

Tipo: HMENU

Um identificador para o menu que contém o item de menu.

[in] item

Tipo: UINT

O identificador ou posição do item de menu sobre o qual obter informações. O significado desse parâmetro depende do valor de fByPosition.

[in] fByPosition

Tipo: BOOL

O significado do Item. Se esse parâmetro for FALSE, Item será um identificador de item de menu. Caso contrário, é uma posição de item de menu. Consulte Acessando itens de menu programaticamente para obter mais informações.

[in, out] lpmii

Tipo: LPMENUITEMINFO

Um ponteiro para uma estrutura MENUITEMINFO que especifica as informações a serem recuperadas e recebe informações sobre o item de menu. Observe que você deve definir o membro cbSize para sizeof(MENUITEMINFO) antes de chamar essa função.

Valor de devolução

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

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

Observações

Para recuperar um item de menu do tipo MFT_STRING, primeiro localize o tamanho da cadeia de caracteres definindo o membro dwTypeData de MENUITEMINFO como NULL e, em seguida, chamando GetMenuItemInfo. O valor de cch+1 é o tamanho necessário. Em seguida, aloque um buffer desse tamanho, coloque o ponteiro para o buffer em dwTypeData, incremente cch por um e chame GetMenuItemInfo mais uma vez para preencher o buffer com a cadeia de caracteres.

Se o item de menu recuperado for de algum outro tipo, GetMenuItemInfo definirá o membro dwTypeData como um valor cujo tipo é especificado pelo membro fTypefType e define cch como 0.

Exemplos

Para obter um exemplo, consulte Exemplo de itens de menu de Owner-Drawn.

Requirements

Consulte também

Conceitual

menus

Referência

Setmenuiteminfo