Compartilhar via

Função PDF (experimental)

  • Artigo

Aplica-se a: Aplicativos de tela Aplicativos baseados em modelo

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Exporte o conteúdo da tela atual para um objeto para uso em vários cenários.

Importante

Descrição

A função PDF permite selecionar uma tela ou partes de uma tela para exportação para um objeto PDF (blob).

Diferentes opções de configuração permitem diferentes resultados para o PDF gerado.

Importante

  • A geração de PDF acontece no dispositivo em que o aplicativo está sendo executado. Dispositivos diferentes, como computadores desktop e dispositivos móveis, terão capacidades diferentes ao gerar um PDF.
  • A geração de um PDF com um tamanho de arquivo excepcionalmente grande pode resultar na falha do aplicativo. Isso depende da capacidade do dispositivo em que você está executando o aplicativo. Esteja ciente do tamanho e número de imagens e quantos dados você deseja incluir no PDF gerado, especificamente para aplicativos destinados ao uso em um dispositivo móvel.

Nota

  • Você só pode gerar um PDF a partir do conteúdo existente na tela em que invocou a função PDF. Por exemplo, se você adicionou a função PDF na tela dois, apenas o conteúdo da tela dois poderá ser incluído no PDF gerado.

Sintaxe

PDF(Tela ou nome do controle, [{Tamanho, DPI, Margem, Orientação, ExpandContainers}])

  • Nome da tela ou do controle - obrigatório. A tela ou controle que contém o conteúdo a ser usado para gerar o PDF. Controles suportados: gGaleria vertical, contêiner de layout vertical, contêiner de layout horizontal, contêiner, tela.

  • Tamanho - opcional. Controla as dimensões do PDF gerado. O valor padrão depende da localidade do usuário do aplicativo; Carta para EUA e Canadá e A4 para outras localidades.

  • DPI - opcional. Controla as dimensões/resolução do PDF gerado. Deve ser um valor maior que 0. O conteúdo que excede o espaço permitido pelas margens especificadas pode resultar em um DPI efetivo mais alto. O valor padrão é 96.

  • Margem - opcional. Uma string que especifica o tamanho do espaço reservado entre o conteúdo e a borda externa do PDF gerado. Cada margem do PDF gerado (superior, direita, inferior, esquerda) pode suportar um valor diferente. As unidades de medida suportadas para este valor incluem pol, cm, mm, pt e px. O valor padrão é 0,5 polegada (12,7 mm) para todas as margens.

  • Orientação - opcional. Controla se o PDF gerado tem orientação retrato (vertical) ou paisagem (horizontal). O valor padrão é retrato (vertical).

  • ExpandContainers - opcional. Booliano. Controla se determinados contêineres com conteúdo que exceda o tamanho alocado são expandidos para exibir todo o conteúdo no PDF gerado. Os controles afetados incluem telas, contêineres, contêineres verticais e horizontais, galerias verticais de altura fixa (não aninhadas), formulários e controles de tela roláveis. O valor padrão é falso.

Exemplos

Fórmula Descrição Resultado
PDF(Screen1) Gera um objeto PDF com as configurações padrão. Um objeto PDF é criado a partir do conteúdo visível da tela Screen1.
PDF(Container1, {Tamanho: A3}) Gera um objeto PDF com o tamanho do papel definido como A3. Um objeto PDF de tamanho A3 é criado a partir do conteúdo visível de Container1.
PDF(Screen1, {DPI: 72, Margem: "25mm", Orientação: "paisagem"}) Gera um objeto PDF com a resolução (DPI) definida como 72, a margem definida como 25 milímetros e a orientação definida como paisagem (horizontal). Um PDF com DPI, margem e orientação especificados é criado no tamanho padrão (dependente da localidade) a partir do conteúdo visível na tela Scren1.
PDF(Screen1, {ExpandContainers: verdadeiro}) Gera um objeto PDF com controles aplicáveis expandidos. Um PDF é criado onde quaisquer contêineres/galerias com mais conteúdo do que o visível são expandidos para mostrar todo o conteúdo no PDF gerado.

Limitações conhecidas

  • Não há suporte para determinados controles. Isso inclui gráficos, Power BI tiles, mapas e algumas configurações de controles PCF de terceiros.

  • Galerias aninhadas não são suportadas.

  • Tipos de script não latinos e pesos e estilos de fonte, como negrito e itálico, podem não aparecer no PDF gerado para algumas fontes.

  • A criação de PDFs preenchíveis não é suportada.