Método DoCmd.SetMenuItem (Access)

O método SetMenuItem executa a ação DefinirItemDoMenu no Visual Basic.

Sintaxe

mais simples. SetMenuItem (MenuIndex, CommandIndex, SubcommandIndex, Flag)

expression Uma variável que representa um objeto DoCmd.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
MenuIndex Obrigatório Variant Um número inteiro, contando de 0, que é o índice válido de um menu na barra de menus personalizada ou na barra de menus global da janela ativa, conforme definido na macro da barra de menus personalizada ou da barra de menus global.

Se você selecionar um menu com esse argumento e deixar os argumentos CommandIndex e SubcommandIndex em branco (ou defini-los como 1), poderá habilitar ou desabilitar o próprio nome do menu. No entanto, você não pode marcar ou desmarcar um nome de menu (o Microsoft Access ignora as configurações acMenuCheck e acMenuUncheck para o argumento Sinalizador para nomes de menu).
CommandIndex Opcional Variant Um inteiro, contando de 0, que é o índice válido de um comando no menu selecionado pelo argumento MenuIndex , conforme definido no grupo de macros que define o menu selecionado para a barra de menus personalizada ou a barra de menus global para a janela ativa.
SubcommandIndex Opcional Variant Um inteiro, contando de 0, que é o índice válido de um subcomando no submenu selecionado pelo argumento CommandIndex , conforme definido no grupo de macros que define o submenu selecionado para a barra de menus personalizada ou a barra de menus global para a janela ativa.
Flag Opcional Variant O estado para o qual você deseja definir o comando ou subcomando. Pode ser uma das seguintes constantes:
  • acMenuCheck
  • acMenuGray
  • acMenuUncheck
  • acMenuUngray (padrão)

Comentários

Use o método SetMenuItem para definir o estado dos itens de menu (habilitados ou desabilitados, marcados ou desmarcados) na barra de menus personalizada ou na barra de menus global da janela ativa.

Observação

[!OBSERVAçãO] O método SetMenuItem funciona somente com barras de menus personalizada e barras de menus globais criadas por meio de macros de barra de menus. O método SetMenuItem está incluído nesta versão do Access somente para compatibilidade com versões anteriores ao Access 97. Ele não funciona com a nova funcionalidade de barras de comando.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.