PDF Función (experimental)

Aplícase a: aplicacións Canvas

[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 PDF función permítelle seleccionar unha pantalla ou partes dunha pantalla para exportar a un PDF obxecto (blob).

Diferentes opcións de configuración permiten diferentes resultados para o resultado xerado PDF.

Importante

  • PDF A xeración ocorre no dispositivo no que se executa a aplicación. Diferentes dispositivos, como ordenadores de escritorio e dispositivos móbiles, terán capacidades diferentes cando se xera un PDF.
  • Xerar un PDF tamaño de ficheiro excepcionalmente grande pode provocar que a aplicación se bloquee. 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 a cantidade de datos que desexa incluír na xerada PDF, especialmente para as aplicacións destinadas ao seu uso nun dispositivo móbil.

Nota

  • Só pode xerar a PDF partir do contido existente na pantalla onde invocou a PDF función. Por exemplo, se engadiu a PDF función na segunda pantalla, só o contido da segunda pantalla pode incluírse na pantalla xerada PDF.

Sintaxe

PDF (Nome da pantalla ou do control [,{Size, DPI, Margin, Orientation, ExpandContainers}])

  • Nome da pantalla ou do control: Obrigatorio. A pantalla ou o control que contén o contido a usar 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 xerado PDF. 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 xerado PDF. 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. Cadea que especifica o tamaño do espazo reservado entre o contido e o bordo exterior do arquivo xerado PDF. Cada marxe xerada PDF (arriba, dereita, abaixo, esquerda) pode soportar 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 xerado PDF ten unha orientación retrato (vertical) ou paisaxe (horizontal). O valor predeterminado é vertical.

  • ExpandContainers: Opcional. Booleano. Controla se certos contedores con contido que supera o tamaño asignado se expanden para mostrar todo o contido do arquivo xerado PDF. 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 Descrición Resultado
PDF(Pantalla 1) Xera un PDF obxecto coa configuración predeterminada. Créase un PDF obxecto a partir do contido visible da pantalla 1.
PDF(Container1, {size: "A3"}) Xera un PDF obxecto co tamaño do papel establecido en A3. Créase un obxecto de tamaño PDF A3 a partir do contido visible de Container1.
PDF(Pantalla1, {DPI: 72, Marxe: "25mm", Orientación: "Paisaxe"}) Xera un PDF obxecto coa resolución (DPI) establecida en 72, a marxe establecida en 25 milímetros e a orientación establecida en paisaxe (horizontal). A PDF co DPI, a marxe e a orientación especificados créase no tamaño predeterminado (dependendo da localización) a partir do contido visible na pantalla 1.
PDF(Screen1, {ExpandContainers: true}) Xera un PDF obxecto cos controis aplicables expandidos. A PDF créase onde todos os contedores / galerías con máis contido do visible son expandidos para mostrar todo o contido do xeito xerado PDF.

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.

  • Os tipos de escritura non latina e os pesos e estilos de letra como a letra grosa e cursiva poden non aparecer no xerado PDF para algúns tipos de letra.

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