Funzione PDF (sperimentale)

Si applica a: App Canvas App basate su modello

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

Esportare i contenuti dalla schermata corrente in un oggetto per l'uso in più scenari.

Importante

Descrizione

La funzione PDF ti consente di selezionare una o più parti di una schermata da esportare in un oggetto PDF (blob).

Diverse opzioni di configurazione producono risultati differenti per il PDF generato risultante.

Importante

  • La generazione del PDF avviene sul dispositivo su cui è in esecuzione l'app. Dispositivi diversi come computer desktop e dispositivi mobili avranno capacità differenti durante la generazione di un PDF.
  • La generazione di un PDF con una dimensione di file eccezionalmente grande può causare l'arresto anomalo dell'app. Ciò dipende dalla capacità del dispositivo su cui stai eseguendo l'app. Tieni presente la dimensione e il numero di immagini e la quantità di dati che desideri includere nel PDF generato, in particolare per le app destinate all'utilizzo su un dispositivo mobile.

Nota

  • Puoi generare un PDF solo dal contenuto esistente sulla schermata da cui hai richiamato la funzione PDF. Ad esempio, se hai aggiunto la funzione PDF nella seconda schermata, solo il contenuto in tale schermata può essere incluso nel PDF generato.

Sintassi

PDF(Nome dello schermo o del controllo [,{Dimensioni, DPI, Margine, Orientamento, EspandiContenitori}])

  • Nome dello schermo o del controllo – Obbligatorio. La schermata o il controllo contenente il contenuto da utilizzare per generare il PDF. Controlli supportati: Raccolta verticale, Contenitore layout verticale, Contenitore layout orizzontale, Contenitore, Schermata.

  • Dimensioni – Facoltativo. Controlla le dimensioni del PDF generato. Il valore predefinito dipende dalle impostazioni locali dell'utente dell'app; Lettera per Stati Uniti e Canada e A4 per altre lingue.

  • DPI – Facoltativo. Controlla il ridimensionamento/la risoluzione del PDF generato. Deve essere un valore maggiore di 0. Il contenuto che supera lo spazio consentito dai margini specificati può comportare un DPI effettivo più elevato. Il valore predefinito è 96.

  • Margine – Facoltativo. Una stringa che specifica la dimensione dello spazio riservato tra il contenuto e il bordo esterno del PDF generato. Ogni margine del PDF generato (in alto, a destra, in basso, a sinistra) può supportare un valore differente. Le unità di misura supportate per questo valore includono pollici, cm, mm, pt e px. Il valore predefinito è 0,5 pollici (12,7 mm) per tutti i margini.

  • Orientamento – Facoltativo. Controlla se il PDF generato ha un orientamento verticale (verticale) o orizzontale (orizzontale). Il valore predefinito è l'orientamento verticale.

  • ExpandContainers – Facoltativo. Booleano. Controlla se determinati contenitori con contenuti che superano le dimensioni assegnate si espandono per visualizzare tutto il contenuto nel PDF generato. I controlli interessati includono schermate, contenitori, contenitori verticali e orizzontali, raccolte verticali ad altezza fissa (non nidificate), moduli e controlli del canvas scorrevole. Il valore predefinito è false.

Esempi

Formula Descrizione Risultato
PDF(Schermata 1) Genera un oggetto PDF con le impostazioni predefinite. Un oggetto PDF viene creato dal contenuto visibile di Screen1.
PDF(Contenitore1, {Dimensione: A3}) Genera un oggetto PDF con il formato carta impostato su A3. Un oggetto PDF in formato A3 viene creato dal contenuto visibile di Container1.
PDF(Schermo1, {DPI: 72, Margine: "25mm", Orientamento: "Orizzontale"}) Genera un oggetto PDF con la risoluzione (DPI) impostata su 72, il margine impostato su 25 millimetri e l'orientamento impostato su orizzontale. Un PDF con DPI, margine e orientamento specificati viene creato nella dimensione predefinita (a seconda delle impostazioni locali) a partire dal contenuto visibile su Screen1.
PDF(Schermata1, {EspandiContenitori: vero}) Genera un oggetto PDF con controlli applicabili espansi. Viene creato un PDF in cui tutti i contenitori/raccolte con più contenuto di quello visibile vengono espansi per mostrare tutto il contenuto nel PDF generato.

Limitazioni note

  • Alcuni controlli non sono attualmente supportati. Questi includono grafici, riquadro di Power BI, Mappa e alcune configurazioni di controlli PCF di terze parti.

  • Le raccolte correlate non sono supportate.

  • Tipi di script non latini, spessore e stili dei caratteri come grassetto e corsivo potrebbero non essere visualizzati nel PDF generato per alcuni caratteri.

  • La creazione di PDF compilabili non è supportata.