Função PDF (experimental)

Aplica-se a: Aplicações de tela Aplicações condicionadas por modelo

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

Exporte conteúdos do ecrã atual para um objeto para utilização em vários cenários.

Importante

• Esta é uma funcionalidade experimental.
• As funcionalidades experimentais não se destinam à produção e poderão ter funcionalidades restritas. Estas caraterísticas estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipadamente e enviar comentários. Mais informações: Compreender caraterísticas experimentais, de pré-visualização e retiradas em aplicações de tela
• O comportamento que este artigo descreve só está disponível quando a caraterística experimental de função PDF em Definições > Caraterísticas futuras > Experimentais está ativada (está desativada por predefinição).
• O seu feedback é valioso para nós. Partilhe a sua opinião no fórum da comunidade de caraterísticas experimentais do Power Apps.

Description

A função PDF permite-lhe selecionar um ecrã ou partes de um ecrã para exportação para um objeto PDF (blob).

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

Importante

• A geração de PDF ocorre no dispositivo onde a aplicação está em execução. Os dispositivos diferentes, como computadores de secretária e dispositivos móveis, terão capacidades diferentes quando estiver a gerar um PDF.
• Gerar um PDF com um tamanho de ficheiro de excecionalmente grande pode resultar na falha da aplicação. Isto depende da capacidade do dispositivo em que está a executar a aplicação. Tenha em atenção o tamanho e o número de imagens e a quantidade de dados que pretende incluir no PDF gerado, especificamente para aplicações que se destinam a utilização num dispositivo móvel.

Nota

• Só pode gerar um PDF a partir de conteúdo existente no ecrã em que invocou a função PDF. Por exemplo, se tiver adicionado a função PDF no ecrã dois, apenas o conteúdo no ecrã dois poderá ser incluído no PDF gerado.

Sintaxe

PDF(Nome do ecrã ou do controlo [,{Tamanho, PPP, Margem, Orientação, ExpandContainers}])

• Nome do ecrã ou do controlo – Obrigatório. O ecrã ou controlo que contém o conteúdo a utilizar para gerar o PDF. Controlos suportados: Vertical Gallery, Vertical Layout Container, Horizontal Layout Container, Container, Screen.

• Tamanho – Opcional. Controla as dimensões do PDF gerado. O valor predefinido depende da região do utilizador da aplicação; Carta para EUA e Canadá e A4 para outras regiões.

• PPP – Opcional. Controla o dimensionamento/resolução do PDF gerado. Tem de ser um valor maior que 0. O conteúdo que excede o espaço permitido pelas margens especificadas pode resultar num PPP mais eficaz. O valor predefinido é 96.

• Margem – Opcional. Uma cadeia que especifica o tamanho do espaço reservado entre o conteúdo e o contorno externo 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 in, cm, mm, pt e px. O valor predefinido é 0,5 polegadas (12,7 mm) para todas as margens.

• Orientação – Opcional. Controla se o PDF gerado tem uma orientação vertical ou horizontal. O valor predefinido é vertical.

• ExpandContainers – Opcional. Booleano. Controla se determinados contentores com conteúdos que excedam o tamanho atribuído se expandem para apresentar todos os conteúdos no PDF gerado. Os controlos afetados incluem ecrãs, contentores, contentores verticais e horizontais, galerias de altura fixa vertical (não aninhadas), formulários e controlos de tela deslocáveis. O valor predefinido é false.

Exemplos

Fórmula	Descrição	Resultado
PDF(Ecrã1)	Gera um objeto de PDF com as predefinições.	Um objeto de PDF é criado a partir do conteúdo visível do Ecrã1.
PDF(Contentor1, {Tamanho: A3})	Gera um objeto de PDF com o tamanho do papel definido como A3.	É criado um objeto de PDF de tamanho A3 a partir do conteúdo visível do Contentor1.
PDF(Ecrã1, {PPP: 72, Margem: "25 mm", Orientação: "Horizontal"})	Gera um objeto de PDF com a resolução (PPP) definida como 72, a margem definida como 25 milímetros e a orientação definida como horizontal.	É criado um PDF com o PPP, a margem e a orientação especificadas no tamanho predefinido (dependente da região) do conteúdo visível no Ecrã1.
PDF(Ecrã1, {ExpandContainers: true})	Gera um objeto de PDF com controlos aplicáveis expandidos.	É criado um PDF onde quaisquer contentores/galerias com mais conteúdo do que o que seja visível são expandidos para mostrar todo o conteúdo no PDF gerado.

Limitações conhecidas

• Atualmente, não são suportados determinados controlos. Estes incluem gráficos, mosaico do Power BI, Mapa e algumas configurações de controlos PCF de terceiros.

• As Galerias Aninhadas não são suportadas.

• Os tipos de script não latinos e espessuras de tipo de letra, tais como negrito e itálico, poderão não aparecer no PDF gerado para alguns tipos de letra.

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