Compartilhar via


Ação da macro ProcurarEm

Aplica-se ao: Access 2013, Office 2013

Você pode usar a ação ProcurarEm para navegar entre objetos no local. Também é possível alterar o objeto de origem em um controle de subformulário, especificando o argumento Caminho para Controle de Subformulário. Use ProcurarEm para navegar do formulário1 para o formulário1 sem precisar abrir uma nova janela.

Setting

A ação ProcurarEm tem os seguintes argumentos.

Argumento da ação

Descrição

Tipo de Objeto

O tipo de objeto até o qual você deseja navegar.

Nome do Objeto

O objeto que carrega o controle de subformulário referenciado pelo argumento Caminho para Controle de Subformulário.

Caminho para Controle de Subformulário

Se especificado, o caminho do main forma do aplicativo para o controle de subformação de destino que carrega o objeto especificado pelo argumento Nome do Objeto.

Condição Where

Se for especificado, substitui a condição Where da origem de registro do objeto.

Page

Se estiver especificado, define a página do formulário contínuo que se tornará a página atual. Esse argumento é somente web.

Modo de Dados

Se for especificado, o modo de entrada de dados do formulário.

Comentários

O argumento CaminhoparaControledeSubformulário deve ser especificado por meio do uso da sintaxe do seguinte exemplo de código:

    Main Form.SubForm Ctrl 1>Form 2.SubForm Ctrl 2>Form 3.SubFormCtrl3

Neste exemplo, o Formulário principal é o formulário de nível superior no aplicativo cliente do Access. O argumento Caminho para Controle de Subformulário deve especificar, alternadamente, os nomes de formulário e de subformulário desde o formulário principal até o controle de subformulário que é o contêiner do objeto especificado pelo argumento Nome de Objeto. Cada controle de subformulário especificado deve ser um controle do formulário que o precede. O caminho deve terminar com um controle de subformulário.

Exemplo

O exemplo a seguir mostra como usar a ação BrowseTo para abrir um relatório em um controle de subformação ou dentro de um controle de navegação.

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

    OnError
        Go to Next
        Macro Name
    
    /* Try to load the report in the host form (frmAuthorsParameter)    */
    BrowseTo
        Object Type Report
        Object Name rptChapters
        Path to Subform Control frmAuthorsParameter.sfrmChild
        Where Condition
        Page
        Data Mode Edit
    
    Parameters
        SelectedAuthor =[cboAuthor]
    
    /* if this fails, try to load it in the navigation subform     */
    BrowseTo
        Object Type Report
        Object Name rptChapters
        Path to Subform Control frmMain.NavigationSubform>frmAuthorsParameter.sfrmChild
        Where Condition
        Page
        Data Mode Edit
    
    Parameters
        SelectedAuthor =[cboAuthor]