Função ModifyMenuA (winuser.h)
Altera um item de menu existente. Essa função é usada para especificar o conteúdo, a aparência e o comportamento do item de menu.
Sintaxe
BOOL ModifyMenuA(
[in] HMENU hMnu,
[in] UINT uPosition,
[in] UINT uFlags,
[in] UINT_PTR uIDNewItem,
[in, optional] LPCSTR lpNewItem
);
Parâmetros
[in] hMnu
Tipo: HMENU
Um identificador para o menu a ser alterado.
[in] uPosition
Tipo: UINT
O item de menu a ser alterado, conforme determinado pelo parâmetro uFlags.
[in] uFlags
Tipo: UINT
Controla a interpretação do parâmetro uPosition e o conteúdo, a aparência e o comportamento do item de menu. Esse parâmetro deve incluir um dos seguintes valores necessários.
O parâmetro também deve incluir pelo menos um dos valores a seguir.
| Valor | Significado |
|---|---|
|
Usa um bitmap como o item de menu. O parâmetro lpNewItem contém um identificador para o bitmap. |
|
Coloca uma marca de seleção ao lado do item. Se o aplicativo fornecer bitmaps de marca de seleção (consulte a função SetMenuItemBitmaps), esse sinalizador exibirá um bitmap selecionado ao lado do item de menu. |
|
Desabilita o item de menu para que ele não possa ser selecionado, mas esse sinalizador não o cinza. |
|
Habilita o item de menu para que ele possa ser selecionado e restaurá-lo de seu estado esmaecido. |
|
Desabilita o item de menu e o cinza para que ele não possa ser selecionado. |
|
Funciona da mesma forma que o sinalizador MF_MENUBREAK para uma barra de menus. Para um menu suspenso, submenu ou menu de atalho, a nova coluna é separada da coluna antiga por uma linha vertical. |
|
Coloca o item em uma nova linha (para barras de menus) ou em uma nova coluna (para um menu suspenso, submenu ou menu de atalho) sem separar colunas. |
|
Especifica que o item é um item desenhado pelo proprietário. Antes que o menu seja exibido pela primeira vez, a janela que possui o menu recebe uma mensagem WM_MEASUREITEM para recuperar a largura e a altura do item de menu. A mensagem WM_DRAWITEM é enviada para o procedimento de janela da janela do proprietário sempre que a aparência do item de menu deve ser atualizada. |
|
Especifica que o item de menu abre um menu suspenso ou submenu. O parâmetro uIDNewItem especifica um identificador para o menu suspenso ou submenu. Esse sinalizador é usado para adicionar um nome de menu a uma barra de menus ou a um item de menu que abre um submenu em um menu suspenso, submenu ou menu de atalho. |
|
Desenha uma linha divisória horizontal. Esse sinalizador é usado apenas em um menu suspenso, submenu ou menu de atalho. A linha não pode ser esmaeçada, desabilitada ou realçada. Os parâmetros lpNewItem e uIDNewItem são ignorados. |
|
Especifica que o item de menu é uma cadeia de caracteres de texto; o parâmetro lpNewItem é um ponteiro para a cadeia de caracteres. |
|
Não coloca uma marca de seleção ao lado do item (o padrão). Se o aplicativo fornecer bitmaps de marca de seleção (consulte a função SetMenuItemBitmaps), esse sinalizador exibirá um bitmap claro ao lado do item de menu. |
[in] uIDNewItem
Tipo: UINT_PTR
O identificador do item de menu modificado ou, se o parâmetro uFlags tiver o sinalizador MF_POPUP definido, um identificador para o menu suspenso ou submenu.
[in, optional] lpNewItem
Tipo: LPCTSTR
O conteúdo do item de menu alterado. A interpretação desse parâmetro depende se o parâmetro uFlags inclui o sinalizador MF_BITMAP, MF_OWNERDRAWou MF_STRING.
| Valor | Significado |
|---|---|
|
Um identificador de bitmap. |
|
Um valor fornecido por um aplicativo que é usado para manter dados adicionais relacionados ao item de menu. O valor está no itemData membro da estrutura apontado pelo parâmetro lParam das mensagens WM_MEASUREITEM ou WM_DRAWITEM enviadas quando o item de menu é criado ou sua aparência é atualizada. |
|
Um ponteiro para uma cadeia de caracteres terminada em nulo (o padrão). |
Valor de retorno
Tipo: BOOL
Se a função for bem-sucedida, o valor retornado não será zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Observações
Se ModifyMenu substituirá um item de menu que abre um menu suspenso ou submenu, a função destruirá o menu suspenso antigo ou o submenu e liberará a memória usada por ele.
Para que os aceleradores de teclado funcionem com itens de menu desenhados pelo proprietário ou bitmap, o proprietário do menu deve processar a mensagem WM_MENUCHAR. Consulte Owner-Drawn Menus e o de Mensagem WM_MENUCHAR para obter mais informações.
O aplicativo deve chamar a função DrawMenuBar sempre que um menu for alterado, se o menu estiver em uma janela exibida. Para alterar os atributos dos itens de menu existentes, é muito mais rápido usar as funções CheckMenuItem e EnableMenuItem.
Os seguintes grupos de sinalizadores não podem ser usados juntos:
- MF_BYCOMMAND e MF_BYPOSITION
- MF_DISABLED, MF_ENABLEDe MF_GRAYED
- MF_BITMAP, MF_STRING, MF_OWNERDRAWe MF_SEPARATOR
- MF_MENUBARBREAK e MF_MENUBREAK
- MF_CHECKED e MF_UNCHECKED
Exemplos
Para obter um exemplo, consulte Definindo fontes para cadeias de caracteres de texto Menu-Item.
Nota
O cabeçalho winuser.h define ModifyMenu 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
CheckMenuItem
Conceitual
EnableMenuItem
de referência de