Comparteix a través de


Funció PDF (experimental)

S'aplica a: Aplicacions del llenç Aplicacions basades en models

[Aquest article forma part de la documentació preliminar i està subjecte a canvis.]

Exporteu el contingut de la pantalla actual a un objecte per utilitzar-lo en diversos escenaris.

Important

Descripció

La funció PDF us permet seleccionar una pantalla o algunes parts d'una pantalla per exportar-la a un objecte PDF (blob).

Les diferents opcions de configuració permeten diferents resultats per al PDF generat resultant.

Important

  • La generació de PDF es produeix al dispositiu on s'executa l'aplicació. Diversos dispositius, com ara ordinadors de sobretaula i dispositius mòbils, tindran diferents capacitats quan genereu un PDF.
  • Generar un PDF amb una mida de fitxer excepcionalment gran pot fer que l'aplicació es bloquegi. Això depèn de la capacitat del dispositiu en què executeu l'aplicació. Tingueu en compte la mida i el nombre d'imatges i la quantitat de dades que voleu incloure al PDF generat, específicament per a les aplicacions dissenyades per utilitzar-les en un dispositiu mòbil.

Nota

  • Només podeu generar un PDF a partir del contingut existent a la pantalla on heu invocat la funció PDF. Per exemple, si heu afegit la funció PDF a la pantalla dos, només el contingut de la pantalla dos es pot incloure en el PDF generat.

Sintaxi

PDF(Nom de pantalla o control [,{Size, DPI, Margin, Orientation, ExpandContainers}])

  • Nom de pantalla o control : necessari. La pantalla o el control amb el contingut que s'utilitzarà per generar el PDF. Controls compatibles: galeria vertical, contenidor de disposició vertical, contenidor de disposició horitzontal, contenidor, pantalla.

  • Mida: opcional. Controla les dimensions del PDF generat. El valor per defecte depèn de la configuració regional de l'usuari de l'aplicació; Carta per als EUA i el Canadà i A4 per a altres regions.

  • DPI: opcional. Controla l'escala/resolució del PDF generat. Ha de ser un valor superior a 0. El contingut que excedeix l'espai permès als marges especificats pot tenir com a conseqüència un DPI eficaç superior. El valor per defecte és 96.

  • Marge: opcional. Cadena que especifica la mida de l'espai reservat entre el contingut i la vora superior del PDF generat. Cada marge del PDF generat (superior, dreta, inferior o esquerra) admet un valor diferent. Les unitats de mesura admeses per a aquest valor poden ser in, cm, mm, pt i px. El valor per defecte és de 0,5 polzades (12,7 mm) per a tots els marges.

  • Orientació: opcional. Controla si el PDF generat té una orientació vertical o horitzontal. El valor per defecte és vertical.

  • ExpandContainers: opcional. Booleà. Controla si alguns contenidors amb contingut que superen la seva mida assignada s'expandeix per mostrar tot el contingut en el PDF generat. Alguns controls afectats són les pantalles, els contenidors, els contenidors verticals i horitzontals, les galeries d'alçada fixa verticals (no imbricades), els formularis i els controls de llenç desplaçable. El valor per defecte és "fals".

Exemples

Fórmula Descripció Resultat
PDF(Screen1) Genera un objecte PDF amb la configuració per defecte. Un objecte PDF es crea a partir del contingut visible de la Pantalla 1.
PDF(Container1, {Mida: A3}) Genera un objecte PDF amb la mida de paper establerta en A3. Es crea un objecte PDF de mida A3 a partir del contingut visible de Container1.
PDF(Screen1, {DPI: 72, Marge: "25mm", Orientació: "Horitzontal"}) Genera un objecte PDF amb la resolució (DPI) definida en 72, el marge definit en 25 mil·límetres i l'orientació establerta en horitzontal. Es crea un PDF amb el DPI, el marge i l'orientació especificats amb la mida per defecte (segons la configuració regional) del contingut visible a la pantalla 1.
PDF(Screen1, {ExpandContainers: true}) Genera un objecte PDF amb els controls aplicables ampliats. Es crea un PDF on s'expandeix qualsevol contenidor o galeria amb més contingut del que està visible per mostrar tot el contingut en el PDF generat.

Limitacions conegudes

  • Actualment, alguns controls no estan admesos. Aquests inclouen gràfics, Power BI mosaics, mapes i algunes configuracions de controls PCF de tercers.

  • Les galeries incrustades no s'admeten.

  • Pot ser que els tipus de caràcters, els pesos de font i els estils que no són llatins, així com la negreta i la cursiva, no apareguin en el PDF generat per a algunes fonts.

  • No s'admet la creació de PDF emplenables.