Compartilhar via


Objeto DoCmd (Access)

Use os métodos do objeto DoCmd para executar ações do Microsoft Office Access no Visual Basic. Uma ação realiza tarefas como fechar windows abrir formulários e configurar o valor de controles.

Comentários

Por exemplo, você pode usar o método OpenForm do objeto DoCmd para abrir um formulário ou usar o método Hourglass para alterar o ponteiro do mouse para um ícone de ampulheta.

A maioria dos métodos do objeto DoCmd têm argumentos; alguns são obrigatórios e outros são opcionais. Se você omitir os argumentos opcionais, os argumentos supõem os valores padrão para o método específico. Por exemplo, o método OpenForm usa sete argumentos, mas somente o primeiro argumento nome do formulário, é necessário.

O exemplo a seguir mostra como você pode abrir o formulário de Funcionários no banco de dados atual. Somente os funcionários com o título representante de vendas estão incluídos.

DoCmd.OpenForm "Employees", , ,"[Title] = 'Sales Representative'"

O objeto DoCmd não dá suporte aos métodos correspondentes às seguintes ações:

  • MsgBox. Use a função MsgBox.
  • RunApp. Use a função Shell para executar outro aplicativo.
  • ExecutarCódigo. Execute a função diretamente no Visual Basic.
  • SendKeys. Use a instrução SendKeys.
  • SetValue. Defina o valor diretamente no Visual Basic.
  • StopAllMacros.
  • StopMacro.

Exemplo

O exemplo a seguir abre um formulário no modo Formulário e move para um novo registro.

Sub ShowNewRecord() 
 DoCmd.OpenForm "Employees", acNormal 
 DoCmd.GoToRecord , , acNewRec 
End Sub

Métodos

Confira também

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.