Compartilhar via


Ação da macro ExecutarMacrodeDados

Aplica-se ao: Access 2013, Office 2013

Você pode usar a ação ExecutarMacrodeDados para executar uma macro.

Setting

A ação ExecutarMacrodeDados tem os seguintes argumentos.

Argumento da ação

Descrição

Nome

O nome da macro de dados a ser executada.

Comentários

Você pode usar a ação RunDataMacro em macros, macros de dados nomeadas e os seguintes eventos de macro: após excluir evento macro, após inserir evento macro e evento macro After Update.

O nome da macro de dados deve incluir a tabela à qual ela está anexada (por exemplo, Comments.AddComment, não apenas AddComment).

Quando você selecionar a macro de dados que deseja executar no designer de macros, o Access determinará se a macro de dados exige parâmetros. Se a macro de dados exigir parâmetros, serão exibidas caixas de texto em que você pode digitar os argumentos.

Quando você executa uma macro que contém a ação ExecutarMacrodeDados e ela alcançar a ação ExecutarMacrodeDados, o Access executará a macro de dados chamada. Após a conclusão da macro de dados chamada, o Access retornará à macro original e executará a próxima ação.

Exemplo

O exemplo a seguir mostra como passar um parâmetro para uma macro de dados nomeada. A macro de dados dmGetCurrentServiceRequest da tabela tblServiceRequests é chamada usando a ação RunDataMacro. Quando o dmGetCurrentServiceRequest for concluído, a variável CurrentServiceRequest retornada forma que a macro de dados é escrita na caixa de texto txtCurrentSR.

Código de exemplo fornecido por: a Referência do programador do Microsoft Access 2010.

    RunDataMacro
        Macro Name tblServiceRequests.dmGetCurrentServiceRequest
    
    Parameters
        prmAssignedTo =[ID]
    
    SetProperty
        Control Name txtCurrentSR
        Property Value
        Value =[ReturnVars]![CurrentServiceRequest]