Compartir por


Función PDF (experimental)

Aplícase a: Aplicacións de lenzo Aplicacións baseadas en modelos

[Este artigo é a documentación de prelanzamento e está suxeito a cambios.]

Exporta o contido da pantalla actual a un obxecto para usar en varios escenarios.

Importante

Descripción

A función PDF permítelle seleccionar unha pantalla ou partes dunha pantalla para exportar a un obxecto PDF (blob).

As diferentes opcións de configuración permiten resultados diferentes para o PDF xerado resultante.

Importante

  • A xeración de PDF ocorre no dispositivo onde se está a executar a aplicación. Distintos dispositivos, como ordenadores de escritorio e dispositivos móbiles, terán capacidades diferentes cando estea xerando un PDF.
  • Xerar un PDF cun tamaño de ficheiro excepcionalmente grande pode provocar un fallo da aplicación. Isto depende da capacidade do dispositivo no que estea executando a aplicación. Teña en conta o tamaño e o número de imaxes e cantos datos quere incluír no PDF xerado, especialmente para aplicacións destinadas a usar nun dispositivo móbil.

Nota

  • Só pode xerar un PDF a partir do contido existente na pantalla onde invocou a función PDF. Por exemplo, se engadiu a función PDF na pantalla dous, só se pode incluír o contido da pantalla dous no PDF xerado.

Sintaxe

PDF(Nome da pantalla ou do control [,{Tamaño, DPI, Marxe, Orientación, ExpandContainers}])

  • Nome da pantalla ou do control: Obrigatorio. A pantalla ou control que contén o contido a utilizar para xerar o PDF. Controis compatibles: Galería vertical, Contedor de deseño vertical, Contedor de deseño horizontal, Contedor, Pantalla.

  • Tamaño: Opcional. Controla as dimensións do PDF xerado. O valor predeterminado depende da configuración rexional do usuario da aplicación; Carta para Estados Unidos e Canadá e A4 para outras localidades.

  • DPI – Opcional. Controla a escala/resolución do PDF xerado. Debe ser un valor maior que 0. O contido que excede o espazo permitido polas marxes especificadas pode producir un DPI efectivo máis elevado. O valor predefinido é 96.

  • Marxe – Opcional. Unha cadea que especifica o tamaño do espazo reservado entre o contido e o bordo exterior do PDF xerado. Cada marxe do PDF xerado (arriba, dereita, inferior, esquerda) pode admitir un valor diferente. As unidades de medida admitidas para este valor inclúen polgadas, cm, mm, pt e px. O valor predeterminado é 0,5 polgadas (12,7 mm) para todas as marxes.

  • Orientación – Opcional. Controla se o PDF xerado ten unha orientación vertical (vertical) ou horizontal (horizontal). O valor predeterminado é vertical.

  • ExpandContainers – Opcional. Booleano. Controla se certos contedores con contidos que superan o seu tamaño asignado se expanden para mostrar todo o contido no PDF xerado. Os controis afectados inclúen pantallas, contedores, contedores verticais e horizontais, galerías verticais de altura fixa (non aniñadas), formularios e controis de lenzo desprazable. O valor predefinido é false.

Exemplos

Fórmula Descripción Resultado
PDF(Screen1) Xera un obxecto PDF coa configuración predeterminada. Créase un obxecto PDF a partir dos contidos visibles de Screen1.
PDF(Container1, {Size: A3}) Xera un obxecto PDF co tamaño de papel definido en A3. Créase un obxecto PDF de tamaño A3 a partir dos contidos visibles de Container1.
PDF(Screen1, {DPI: 72, Margin: "25mm", Orientation: "Landscape"}) Xera un obxecto PDF coa resolución (DPI) establecida en 72, a marxe en 25 milímetros e a orientación en horizontal (horizontal). Créase un PDF co DPI, a marxe e a orientación especificados no tamaño predeterminado (dependendo da rexión) a partir do contido visible en Screen1.
PDF(Screen1, {ExpandContainers: true}) Xera un obxecto PDF cos controis aplicables expandidos. Créase un PDF onde se amplían os contedores/galerías con máis contido do visible para mostrar todo o contido do PDF xerado.

Limitacións coñecidas

  • Non se admiten determinados controis. Estes inclúen gráficos, Power BI mosaicos, mapas e algunhas configuracións de controis PCF de terceiros.

  • Non se admiten galerías aniñadas.

  • É posible que os tipos de escritura non latinos e os pesos e estilos de fonte, como a negra e a cursiva, non aparezan no PDF xerado para algunhas fontes.

  • Non se admite a creación de PDF que se poidan encher.