Función PDF (experimental)

Se aplica a: Aplicaciones de Canvas Aplicaciones basadas en modelos

[Este artículo es documentación preliminar y está sujeto a modificaciones].

Exporte contenido de la pantalla actual a un objeto para usarlo en múltiples escenarios.

Importante

• Esta es una característica experimental.
• Las características experimentales no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios. Más información: Comprender las funciones experimentales, de vista previa y retiradas en aplicaciones de lienzo
• El comportamiento que se describe en este artículo solo está disponible cuando la característica experimental de función PDF de Ajustes > Próximas funciones > Experimental está activada (desactivada de forma predeterminada).
• Sus comentarios son muy valiosos para nosotros. Denos su opinión en los foros de la comunidad de características experimentales de Power Apps.

Descripción

La función PDF le permite seleccionar una pantalla o partes de una pantalla para exportar a un objeto PDF (blob).

Diferentes opciones de configuración permiten diferentes resultados para el PDF generado resultante.

Importante

• La generación de PDF ocurre en el dispositivo donde se ejecuta la aplicación. Diferentes dispositivos, como computadoras de escritorio y dispositivos móviles, tendrán diferentes capacidades cuando genere un PDF.
• Generar un PDF con un tamaño de archivo excepcionalmente grande puede provocar que la aplicación se bloquee. Esto depende de la capacidad del dispositivo en el que esté ejecutando la aplicación. Tenga en cuenta el tamaño y la cantidad de imágenes y la cantidad de datos que desea incluir en el PDF generado, específicamente para aplicaciones destinadas a su uso en un dispositivo móvil.

Nota

• Solo puede generar un PDF a partir del contenido existente en la pantalla donde invocó la función PDF. Por ejemplo, si ha agregado la función PDF en la pantalla dos, solo el contenido de la pantalla dos se puede incluir en el PDF generado.

Sintaxis

PDF(Nombre de pantalla o control [,{Tamaño, DPI, Margen, Orientación, ExpandirContenedores}])

• Nombre de la pantalla o control – Obligatorio. La pantalla o control que contiene el contenido que se usará para generar el PDF. Controles admitidos: galería vertical, contenedor de diseño vertical, contenedor de diseño horizontal, contenedor, pantalla.

• Tamaño – Opcional. Controla las dimensiones del PDF generado. El valor predeterminado depende de la configuración regional del usuario de la aplicación; Carta para EE. UU. y Canadá y A4 para otras configuraciones regionales.

• DPI – Opcional. Controla el escalado/resolución del PDF generado. Debe ser un valor mayor que 0. El contenido que exceda el espacio permitido por los márgenes especificados puede resultar en un DPI efectivo más alto. El valor predeterminado es 96.

• Margen – Opcional. Una cadena que especifica el tamaño del espacio reservado entre el contenido y el borde exterior del PDF generado. Cada margen del PDF generado (superior, derecho, inferior, izquierdo) puede admitir un valor diferente. Las unidades de medida admitidas para este valor incluyen pulgadas, cm, mm, pt y px. El valor predeterminado es 0,5 pulgadas (12,7 mm) para todos los márgenes.

• Orientación – Opcional. Controla si el PDF generado tiene una orientación vertical (vertical) u horizontal (horizontal). El valor predeterminado es vertical.

• ExpandContainers – Opcional. Booleano. Controla si ciertos contenedores con contenidos que exceden su tamaño asignado se expanden para mostrar todo el contenido en el PDF generado. Los controles afectados incluyen pantallas, contenedores, contenedores verticales y horizontales, galerías verticales de altura fija (no anidadas), formularios y controles de lienzo desplazables. El valor predeterminado es falso.

Ejemplos

Fórmula	Descripción	Resultado
PDF (Pantalla 1)	Genera un objeto PDF con la configuración predeterminada.	Se crea un objeto PDF a partir del contenido visible de Screen1.
PDF(Contenedor1, {Tamaño: A3})	Genera un objeto PDF con el tamaño de papel establecido en A3.	Se crea un objeto PDF de tamaño A3 a partir del contenido visible de Container1.
PDF(Pantalla 1, {DPI: 72, Margen: "25 mm", Orientación: "Horizontal"})	Genera un objeto PDF con la resolución (DPI) establecida en 72, el margen establecido en 25 milímetros y la orientación establecida en paisaje (horizontal).	Se crea un PDF con el DPI, el margen y la orientación especificados en el tamaño predeterminado (según la configuración regional) a partir del contenido visible en la Pantalla1.
PDF(Pantalla1, {ExpandirContenedores: verdadero})	Genera un objeto PDF con los controles aplicables expandidos.	Se crea un PDF donde cualquier contenedor o galería con más contenido del visible se expande para mostrar todo el contenido del PDF generado.

Limitaciones conocidas

• Algunos controles no se admiten actualmente. Estos incluyen gráficos, mosaico de Power BI, mapa y algunas configuraciones de controles PCF de terceros.

• Las galerías anidadas no son compatibles.

• Los tipos de escritura no latina y los pesos y estilos de fuente, como negrita y cursiva, pueden no aparecer en el PDF generado para algunas fuentes.

• No se admite la creación de archivos PDF rellenables.