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.

Configuração

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 secção Argumentos de Ação do painel Construtor de Macros mostra todos os relatórios na base 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 controlo no formulário que contém o valor que pretende que os registos no relatório correspondam.

NOTA: o comprimento máximo do argumento Condição Where é de 255 carateres. 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.

NOTA: algumas definições de argumentos do Modo de Janela não se aplicam ao utilizar documentos com separadores. Para alternar para janelas sobrepostas:

  1. Clique em Opções.

  2. Na caixa de diálogo Opções do Access, clique em Banco de Dados Atual.

  3. Na seção Opções do Aplicativo, em Opções de Janela de Documento, clique em Janelas Sobrepostas.

  4. Clique em OK e, em seguida, feche e reabra a base 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 seguinte mostra como utilizar a ação OpenReport para transmitir um parâmetro que filtra um relatório à medida que é aberto. O relatório rptChapters apresenta os registos do autor especificado ao transmitir 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]
  • Last updated on