Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a:
aplicativos Canvas
[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
- Este é um recurso experimental.
- Os recursos experimentais não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários. Mais informações: Compreender os recursos experimentais, em versão preliminar e descontinuados em aplicativos de tela
- O comportamento que este artigo descreve está disponível somente quando o recurso experimental de PDF função em Configurações > Futuros recursos > experimentais está ativado (ele está desativado por padrão).
- Seus comentários são valiosos para nós. Diga o que você pensa no fórum da comunidade de recursos experimentais do Power Apps.
Descrição
A PDF função permite que você selecione uma tela ou partes de uma tela para exportar para um PDF objeto (blob).
Diferentes opções de configuração permitem resultados diferentes para o resultado gerado PDF.
Importante
- PDF a geração ocorre no dispositivo em que o aplicativo está em execução. Dispositivos diferentes, como computadores desktop e dispositivos móveis, terão capacidades diferentes quando você estiver gerando um PDF.
- Gerar 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. Lembre-se do tamanho e do número de imagens e quantos dados você deseja incluir no gerado PDF, especificamente para aplicativos destinados a uso em um dispositivo móvel.
Nota
- Você só pode gerar um PDF conteúdo existente na tela em que invocou a PDF função. Por exemplo, se você adicionou a PDF função na tela dois, somente o conteúdo na tela dois poderá ser incluído no gerado PDF.
Sintaxe
PDF (Nome da tela ou controle [,{Tamanho, DPI, Margem, Orientação, ExpandContainers}])
Nome da tela ou controle – Obrigatório. A tela ou o 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 gerado PDF. 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 o dimensionamento/resolução do gerado PDF. 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 cadeia de caracteres que especifica o tamanho do espaço reservado entre o conteúdo e a borda externa do gerado PDF. Cada margem do gerado PDF (superior, direito, inferior, esquerdo) pode dar suporte a 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 gerado PDF tem uma 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 excedem o tamanho alocado se expandem para exibir todo o conteúdo no gerado PDF. 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(Tela1) | Gera um PDF objeto com as configurações padrão. | Um PDF objeto é criado com base no conteúdo visível da Tela1. |
| PDF(Contêiner1, {Tamanho: "A3"}) | Gera um PDF objeto com o tamanho do papel definido como A3. | Um objeto do tamanho PDF de A3 é criado a partir do conteúdo visível de Container1. |
| PDF(Tela1, {DPI: 72, Margem: "25mm", Orientação: "Paisagem"}) | Gera um PDF objeto 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 o DPI, a margem e a orientação especificados é criado no tamanho padrão (dependente da localidade) do conteúdo visível na Tela1. |
| PDF(Screen1, {ExpandContainers: true}) | Gera um PDF objeto com controles aplicáveis expandidos. | Um PDF é criado em que todos os contêineres/galerias com mais conteúdo do que visível são expandidos para mostrar todo o conteúdo no gerado PDF. |
Limitações conhecidas
Não há suporte para determinados controles. Isso inclui gráficos, bloco do Power BI, Mapa e algumas configurações de controles PCF de terceiros.
Galerias aninhadas não são suportadas.
Tipos de script não latinos e pesos de fonte e estilos como negrito e itálico podem não aparecer no gerado PDF para algumas fontes.
A criação de PDFs preenchíveis não é suportada.