Ação da macro AbrirRelatório

Aplica-se ao: Access 2013, Office 2013

Você pode usar a ação AbrirRelatório para abrir um relatório em modo Design ou Visualizar Impressão, ou para enviar o relatório diretamente para a impressora. Também pode restringir os registros impressos no relatório.

Setting

A ação AbrirRelatório tem os seguintes argumentos.

Argumento da ação	Descrição
Nome do relatório	O nome do relatório que será aberto. A caixa Nome do Relatório na seção Argumentos de Ação do painel Construtor de Macro mostra todos os relatórios no banco de dados atual. Este é um argumento obrigatório. Se você executar uma macro que contém a ação AbrirRelatório em um banco de dados biblioteca, o Microsoft Access procurará o relatório com esse nome primeiro no banco de dados biblioteca e depois no banco de dados atual.
Exibir	O modo de exibição no qual o relatório será aberto. Clique em Imprimir (imprimir o relatório imediatamente), Design ou Visualizar Impressão na caixa Modo de Exibição. O padrão é Imprimir.
Nome do Filtro	Um filtro que restringe os registros do relatório. Você pode digitar o nome de uma consulta existente ou de um filtro que foi salvo como consulta. Entretanto, a consulta precisa incluir todos os campos no relatório que você está abrindo ou ter a propriedade SaídaTodosOsCampos definida como Sim.
Condição Where	Uma cláusula SQL WHERE (sem a palavra WHERE) válida ou expressão que o Access usa para selecionar registros da tabela ou consulta subjacente do relatório. Se você selecionar um filtro com o argumento Nome do Filtro, o Access aplicará essa cláusula WHERE aos resultados do filtro. Para abrir um relatório e restringir seus registros àqueles especificados pelo valor de um controle em um relatório, use a expressão a seguir: [nome_do_campo] = Formulários![nome_do_formulário]![nome do controle em um formulário] Substitua nome_do_campo pelo nome de um campo na tabela ou consulta subjacente do relatório que será aberto. Substitua formname e controlname no formulário pelo nome do formulário e o controle no formulário que contém o valor que você deseja que os registros no relatório correspondam. OBSERVAÇÃO: o comprimento máximo do argumento Where Condition é de 255 caracteres. Se você precisar inserir uma cláusula SQL WHERE mais complexa e extensa do que essa, use o método OpenReport do objeto DoCmd em um módulo do VBA (Visual Basic for Applications). É possível inserir instruções de cláusulas SQL WHERE de até 32.768 caracteres no VBA.
Modo Janela	O modo no qual o relatório será aberto. Clique em Normal, Oculto, Ícone ou Caixa de Diálogo na caixa Modo de Janela . O padrão é Normal. OBSERVAÇÃO: algumas configurações de argumento do Modo de Janela não se aplicam ao usar documentos com guias. Para alternar para janelas sobrepostas: Clique em Opções. Na caixa de diálogo Opções do Access, clique em Banco de Dados Atual. Na seção Opções do Aplicativo, em Opções de Janela de Documento, clique em Janelas Sobrepostas. Clique em OK e feche e reabra o banco de dados.

Comentários

A configuração Imprimir do argumento Modo de Exibição imprime o relatório imediatamente usando as configurações de impressora atuais, sem exibir a caixa de diálogo Imprimir. Você também pode usar a ação AbrirRelatório para abrir e configurar um relatório e usar a ação Imprimir para imprimi-lo. Por exemplo, convém modificar o relatório ou usar a ação Imprimir para alterar as configurações de impressora antes de imprimir.

O filtro e a condição WHERE aplicados se tornam a configuração da propriedade Filtro do relatório.

A ação AbrirRelatório é semelhante a clicar duas vezes no relatório do Painel de Navegação ou a clicar com o botão direito do mouse no relatório do Painel de Navegação e selecionar um modo de exibição ou o comando Imprimir.

Dica

• Para imprimir relatórios semelhantes para diferentes conjuntos de dados, use um filtro ou uma cláusula WHERE para restringir os registros impressos no relatório. Edite a macro para aplicar um filtro diferente ou altere o argumento Condição Onde.

• Você pode arrastar um relatório do Painel de Navegação para uma linha de ação de macro. Isso cria automaticamente uma ação AbrirRelatório que abre o relatório em modo Relatório.

Exemplo

O exemplo a seguir mostra como usar a ação OpenReport para passar um parâmetro que filtra um relatório à medida que ele é aberto. O relatório rptChapters exibe os registros do autor especificado passando o item selecionado na caixa de combinação cboAuthors para o parâmetro SelectedAuthor.

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

    OpenReport
        Report Name rptChapters
        View Report
        Filter Name
        Where Condition
        Window Mode Normal
    
    Parameters
        SelectedAuthor =[cboAuthor]