Compartilhar via


Método DoCmd.SetMenuItem (Access)

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

Sintaxe

expressão. 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 Variantes Um inteiro, contando a partir de 0, que é o índice válido de um menu na barra de menus personalizada ou na barra de menus global para a janela ativa, conforme definido na macro da barra de menus para a barra de menus personalizada ou a 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), você poderá habilitar ou desabilitar o nome do menu em si. No entanto, você não pode verificar 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 Variantes Um inteiro, contando a partir de 0, é o índice válido de um comando no menu selecionado pelo argumento MenuIndex , conforme definido no grupo macro que define o menu selecionado para a barra de menus personalizada ou a barra de menus global para a janela ativa.
SubcommandIndex Opcional Variantes Um inteiro, contando a partir de 0, é o índice válido de um subcomunhão no submenu selecionado pelo argumento CommandIndex , conforme definido no grupo macro 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, verificados ou desmarcados) na barra de menus personalizada ou na barra de menus global para a 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 apenas 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.