Método DoCmd.RunDataMacro (Access)

Use o método RunDataMacro para executar uma macro de dados nomeada do Visual Basic.

Sintaxe

expressão. RunDataMacro (MacroName)

expression Uma variável que representa um objeto DoCmd.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
MacroName	Obrigatório	Variantes	Nome da macro salva. O nome deve incluir o nome da tabela à qual a macro de dados está anexada (por exemplo, Comments.AddComment).

Comentários

Use o método RunDataMacro para reutilizar uma macro de dados nomeada no código do Visual Basic.

Se a macro de dados exigir parâmetros, primeiro você deve criá-los usando o método SetParameter antes de chamar o método RunDataMacro . Cada chamada para SetParameter cria um único parâmetro nomeado.

Exemplo

O exemplo de código a seguir cria dois parâmetros para serem usados pela macro de dados AdicionarComentário. Os dois parâmetros são chamados prmComment e prmRelatedID, respectivamente. O valor da caixa de texto txtComment é armazenado no parâmetro prmComment. O valor da caixa de texto txtId é armazenado no parâmetro prmRelatedID. A macro de dados "Comments.AddComment" é executada.

Private Sub cmdAddComment_Click() 
DoCmd.SetParameter "prmComment", Me.txtComment 
DoCmd.SetParameter "prmRelatedID", Me.txtId 
DoCmd.RunDataMacro "Comments.AddComment" 
End Sub

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.