Método DoCmd.DoMenuItem (Access)

Exibe o comando de menu ou da barra de ferramentas adequado para o Microsoft Access.

Sintaxe

expressão. DoMenuItem (MenuBar, MenuName, Comando, Subcomando,Versão)

expression Uma variável que representa um objeto DoCmd.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
MenuBar Obrigatório Variantes Use a acFormBar constante intrínseca para a barra de menus no modo de exibição Formulário. Para outras exibições, use o número do modo de exibição na lista de argumentos MenuBar , conforme mostrado na janela Macro em versões anteriores do Microsoft Access (contagem regressiva da lista, a partir de 0).
MenuName Obrigatório Variantes Use uma das seguintes constantes intrínsecas:
  • acFile

  • acEditMenu

  • acRecordsMenu

Use acRecordsMenu somente para a barra de menus De exibição de formulário nos bancos de dados Access versão 2.0 e Access 95. Para outros menus, use o número do menu na lista de argumentos MenuName , conforme mostrado na janela Macro em versões anteriores do Access (contagem regressiva da lista, a partir de 0).

Comando Obrigatório Variantes Use uma das seguintes constantes intrínsecas:
  • acNew

  • acSaveForm

  • acSaveFormAs

  • acSaveRecord

  • acUndo

  • acCut

  • acCopy

  • acPaste

  • acDelete

  • acSelectRecord

  • acSelectAllRecords

  • acObjectRefresh

Para outros comandos, use o número do comando na lista de argumentos comando , conforme mostrado na janela Macro em versões anteriores do Access (conte abaixo a lista, começando a partir de 0).

Subcomando Opcional Variantes Use uma das seguintes constantes intrínsecas:
  • acObjectVerb

  • acObjectUpdate

A constante acObjectVerb representa o primeiro comando no submenu do comando Objeto no menu Editar. O tipo de objeto determina o primeiro comando do submenu. Por exemplo, esse comando é Editar para um objeto Paintbrush que pode ser editado.

Para outros comandos no submenus, use o número do subcomunhão na lista de argumentos Subcomando , conforme mostrado na janela Macro nas versões anteriores do Access (conte a lista, a partir de 0).

Versão Opcional Variantes Use a constante intrínseca acMenuVer70 para código escrito para bancos de dados access 95, a constante intrínseca acMenuVer20 para código escrito para bancos de dados Access versão 2.0 e a constante intrínseca acMenuVer1X para código escrito para bancos de dados access versão 1.x. Esse argumento só está disponível no Visual Basic.

OBSERVAÇÃO: o padrão para esse argumento é acMenuVer1X, de modo que qualquer código escrito para bancos de dados access versão 1.x será executado inalterado. Se você estiver escrevendo código para um banco de dados access 95 ou versão 2.0 e quiser usar os comandos de menu access 95 ou versão 2.0 com o método DoMenuItem , você deve definir esse argumento como acMenuVer70 ou acMenuVer20.

Além disso, quando você está contando as listas para os argumentos de ação MenuBar, MenuName, Comando e Subcomunagem na janela Macro para obter os números a serem usados para os argumentos no método DoMenuItem , você deve usar as listas do Access 95 se o argumento Versão for acMenuVer70, a versão access 2.0 lista se o argumento Versão for Versão, e a versão 1.x do Access lista se a versão for acMenuVer1X (ou em branco).

OBSERVAÇÃO: não há nenhuma configuração acMenuVer80 para este argumento. Você não pode usar o método DoMenuItem para exibir comandos access (embora os métodos DoMenuItem existentes no código do Visual Basic ainda funcionem). Em vez disso, use o método RunCommand .

Comentários

Observação

No Microsoft Access 97 e posterior, o método DoMenuItem foi substituído pelo método RunCommand . O método DoMenuItem está incluído nesta versão do Access apenas para compatibilidade com versões anteriores. Ao executar o código do Visual Basic existente que contém um método DoMenuItem , o Access exibirá o menu ou o comando da barra de ferramentas apropriado para o Access 2000. No entanto, ao contrário da ação DoMenuItem em uma macro, um método DoMenuItem no código do Visual Basic não é convertido em um método RunCommand quando você converte um banco de dados criado em uma versão anterior do Access.

Alguns comandos de versões anteriores do Access não estão disponíveis no Access e os métodos DoMenuItem que executam esses comandos causarão um erro quando eles são executados no Visual Basic. Edite o código do Visual Basic para substituir ou excluir as ocorrências desses métodos DoMenuItem.

As seleções nas listas para os argumentos de ação MenuName, Comando e Subcomunagem na janela Macro dependem do que você selecionou para os argumentos anteriores. Use os números ou as constantes intrínsecas adequados para cada argumento MenuBar, MenuName, Command e Subcommand.

Se você deixar o argumento Subcommand em branco, mas especificar o argumento Version, inclua a vírgula do argumento Subcommand. Se você deixar os argumentos Subcommand e Version em branco, não use uma vírgula depois do argumento Command.

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.