Jaa


PDF-funktio(kokeellinen)

Soveltuu: Pohjaan perustuvat sovellukset Mallipohjaiset sovellukset

[Tämä artikkeli sisältää julkaisua edeltävää materiaalia ja voi muuttua.]

Vie sisältö nykyisestä näytöstä objektiin käytettäväksi useissa skenaarioissa.

Tärkeä

Description

PDF-funktion avulla voit valita näytön tai osan näytöstä ja viedä sen PDF-objektiin (blob).

Eri määritysvaihtoehdot mahdollistavat erilaisia tuloksia luodulle PDF-tiedostolle.

Tärkeä

  • PDF-tiedoston luonti tapahtuu laitteella, jossa sovellus on käynnissä. Eri laitteilla, kuten pöytätietokoneilla ja mobiililaitteilla, on erilaiset rajoitukset PDF-tiedostoa luotaessa.
  • Jos luotu PDF-tiedosto on poikkeuksellisen suuri, sovellus saattaa kaatua. Tämä riippuu sen laitteen kapasiteetista, jossa käytät sovellusta. Huomioi kuvien koko ja määrä sekä se, kuinka paljon tietoja haluat sisällyttää luotuun PDF-tiedostoon, erityisesti mobiililaitteille tarkoitetuissa sovelluksissa.

Muistiinpano

  • Voit luoda PDF-tiedoston vain sen näytön sisällöstä, josta kutsuit PDF-funktiota. Jos olet lisännyt PDF-funktion esimerkiksi näytölle kaksi, vain näytön kaksi sisältö voidaan lisätä luotuun PDF-tiedostoon.

Syntaksi

PDF(Näytön tai ohjausobjektin nimi [,{Size, DPI, Margin, Orientation, ExpandContainers}])

  • Näytön tai ohjausobjektin nimi – Pakollinen. Näyttö tai ohjausobjekti, joka sisältää PDF-tiedoston luomiseen käytettävän sisällön. Tuetut ohjausobjektit: Pystysuuntainen valikoima, Pystysuuntainen asettelusäilö, Vaakasuuntainen asettelusäilö, Säilö, Näyttö.

  • Size – Valinnainen. Määrittää luodun PDF-tiedoston mitat. Oletusarvo määräytyy sovelluksen käyttäjän sijaintiasetuksen mukaan: Yhdysvalloissa ja Kanadassa Letter ja muualla A4.

  • DPI – Valinnainen. Määrittää luodun PDF-tiedoston mittakaavan/resoluution. Arvon täytyy olla suurempi kuin 0. Jos sisältö ylittää määritettyjen marginaaleiden sallitun tilan, tuloksena voi olla suurempi DPI. Oletusarvo on 96.

  • Margin – Valinnainen. Merkkijono, joka määrittää luodun PDF-tiedoston sisällön ja ulkoreunuksen väliin varatun tilan koon. Luodun PDF-tiedoston jokaisella reunuksella (ylä, oikea, ala, vasen) voi olla eri arvo. Tämän arvon tuetut mittayksiköt ovat in, cm, mm, pt ja px. Oletusarvo on 0,5 tuumaa (12,7 mm) kaikille marginaaleille.

  • Orientation – Valinnainen. Määrittää, onko luotu PDF-tiedosto pysty- vai vaakasuuntainen. Oletusarvo on portrait (pystysuunta).

  • ExpandContainers – Valinnainen. Totuusarvo. Määrittää, laajennetaanko tietyt säilöt näyttämään niiden kaikki sisältö PDF-tiedostossa, jos sisältö ylittää säilöille varatun koon. Tämä vaikuttaa moniin ohjausobjekteihin, kuten näyttöihin, säiliöihin, pysty- ja vaakasuuntaisiin säilöihin, pystysuuntaisiin kiinteän korkeuden valikoimiin (ei sisäkkäisiin), lomakkeisiin ja vieritettävien kaavioiden ohjausobjekteihin. Oletusarvo on epätosi.

Esimerkkejä

Kaava Description Tulos
PDF(Screen1) Luo PDF-objektin oletusasetuksilla. PDF-objekti luodaan Screen1-näytössä näytetystä sisällöstä.
PDF(Container1, {Size: A3}) Luo PDF-objektin, jonka paperikoko on A3. A3-kokoinen PDF-objekti luodaan Container1-säilössä näkyvästä sisällöstä.
PDF(Screen1, {DPI: 72, Margin: "25mm", Orientation: "Landscape"}) Luo PDF-objektin, jonka resoluutio (DPI) on 72, marginaali on 25 millimetriä ja suunta on vaakasuunta. PDF-tiedosto luodaan määritetyllä DPI-arvolla, marginaalilla ja suunnalla oletusarvoisessa koossa (joka riippuu sijaintiasetuksesta) Screen1-näytöllä näytetystä sisällöstä.
PDF(Screen1, {ExpandContainers: true}) Luo PDF-objektin, jonka määritetyt ohjausobjektit on laajennettu. Järjestelmä luo PDF-tiedoston, jossa kaikki säilöt/valikoimat on laajennettu näyttämään niiden kaikki sisältö luodussa PDF-tiedostossa, jos niiden koko sisältö ei ole näkyvissä.

Tunnetut rajoitukset

  • Tiettyjä ohjausobjekteja ei tueta tällä hetkellä. Näitä ovat kaaviot, Power BI -ruutu, kartta ja jotkin kolmansien osapuolten PCF-ohjausobjektien kokoonpanot.

  • Sisäkkäisiä valikoimia ei tueta.

  • Ei-latinalaisia merkkejä ja fonttien painotuksia ja tyylejä, kuten lihavointia ja kursivointia, ei välttämättä näytetä luodossa PDF-tiedostossa kaikille fonteille.

  • Täytettävien PDF-tiedostojen luomista ei tueta.