Método DoCmd.OutputTo (Access)
O método OutputTo executa a ação OutputTo no Visual Basic.
Sintaxe
expression.OutputTo (ObjectType, ObjectName, OutputFormat, OutputFile, AutoStart, TemplateFile, Encoding, OutputQuality)
expressão Uma variável que representa um objeto DoCmd.
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| ObjectType | Obrigatório | AcOutputObjectType | Uma constante AcOutputObjectType que especifica o tipo de objeto de saída. |
| ObjectName | Opcional | Variantes | Uma expressão de cadeia de caracteres que é o nome válido de um objeto do tipo selecionado com o argumento ObjectType. Se você quiser ter como saída o objeto ativo, especifique o tipo do objeto para o argumento ObjectType e deixe esse argumento em branco. Se você executar o código do Visual Basic com o método OutputTo em um banco de dados de biblioteca, o Microsoft Office Access procurará o objeto com esse nome, primeiro no banco de dados da biblioteca, e depois no banco de dados atual. |
| OutputFormat | Optional | AcFormat | Uma constante AcFormat que especifica o formato de saída. Se você omitir esse argumento, o Access solicitará o formato de saída. |
| OutputFile | Optional | Variantes | Uma expressão de cadeia de caracteres que é o nome completo, incluindo o caminho do arquivo de saída ao objeto. Se você deixar esse argumento em branco, o Access solicitará um nome de arquivo de saída. |
| AutoStart | Optional | Variantes | Use True (1) para iniciar o aplicativo baseado no Microsoft Windows apropriados imediatamente, com o arquivo especificado pelo argumento OutputFile carregado. Use False (0) se não quiser iniciar o aplicativo. Este argumento é ignorado para os arquivos do Microsoft Internet Information Server (.htx, .idc) e os arquivos do Microsoft ActiveX Server (*.asp). Se você deixar esse argumento em branco, o padrão (False) é assumido. |
| TemplateFile | Opcional | Variantes | Uma expressão de cadeia de caracteres que é o nome completo, incluindo o caminho do arquivo que você deseja usar como um modelo para um arquivo HTML, HTX ou ASP. |
| Encoding | Optional | Variantes | O tipo de formato de codificação de caractere desejado usado para produzir dados de texto ou HTML. Você pode selecionar MS-DOS, Unicode ou Unicode (UTF-8). A configuração do argumento MS-DOS só está disponível para arquivos de texto. Se você deixar esse argumento em branco, o Access produzirá os dados usando a codificação padrão do Windows para arquivos de texto e a codificação padrão do sistema para arquivos HTML. |
| OutputQuality | Optional | AcExportQuality | Uma constante AcExportQuality que especifica o tipo de dispositivo de saída para otimização. O valor padrão é acExportQualityPrint. |
Comentários
Use o método OutputTo para produzir os dados no objeto de banco de dados do Access especificado (uma folha de dados, um formulário, um relatório, um módulo, uma página de acesso a dados) para vários formatos de saída.
Os módulos só podem ser produzidos ter saída no formato de texto MS-DOS e, portanto, se você especificar acOutputModule para o argumento ObjectType, deverá especificar acFormatTXT para o argumento OutputFormat. Os formatos do Microsoft Internet Information Server e do Microsoft ActiveX Server só estão disponíveis para tabelas, consultas e formulários e, portanto, se você especificar acFormatIIS ou acFormatASP para o argumento OutputFormat, especifique acOutputTable, acOutputQuery ou acOutputForm para o argumento ObjectType.
Os dados do Access são exibidos no formato selecionado e podem ser lidos por qualquer aplicativo que use o mesmo formato. Por exemplo, você pode produzir um relatório do Access com formatação para um documento no formato rich text e abrir o documento no Microsoft Word.
Observação
Você pode salvar como arquivo PDF ou XPS de um programa de sistema do Microsoft Office 2007 somente depois de instalar um suplemento. Para saber mais, confira Suplemento do 2007 Microsoft Office: salvar como PDF ou XPS da Microsoft.
Exemplo
O exemplo de código a seguir exibe a tabela Employees no formato rich text (.rtf) para o arquivo RTF e abre imediatamente o arquivo no Microsoft Word para Windows.
DoCmd.OutputTo acOutputTable, "Employees", _
acFormatRTF, "Employee.rtf", True
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.