Sdílet prostřednictvím


Funkce PDF (experimentální)

Platí pro: aplikace plátna modelem řízené aplikace

[Tento článek představuje předběžnou dokumentaci a může se změnit.]

Exportuje obsah z aktuální obrazovky do objektu pro použití ve více scénářích.

Důležité

Description

Funkce PDF vám umožňuje vybrat obrazovku nebo části obrazovky pro export do objektu PDF (blobu).

Různé možnosti konfigurace umožňují různé výsledky pro výsledný generovaný soubor PDF.

Důležité

  • Generování PDF probíhá na zařízení, kde je aplikace spuštěna. Různá zařízení, jako jsou stolní počítače a mobilní zařízení, budou mít při generování PDF různé kapacity.
  • Generování PDF s mimořádně velkou velikostí souboru může způsobit selhání aplikace. To závisí na kapacitě zařízení, na kterém aplikaci spouštíte. Uvědomte si velikost a počet obrázků a množství dat, které chcete zahrnout do vygenerovaného PDF, konkrétně pro aplikace určené pro použití na mobilním zařízení.

Poznámka:

  • PDF můžete vygenerovat pouze z obsahu existujícího na obrazovce, kde jste vyvolali funkci PDF. Pokud jste například přidali funkci PDF na druhou obrazovku, pak lze do vygenerovaného PDF zahrnout pouze obsah na druhé obrazovce.

Syntaxe

PDF(Název obrazovky nebo ovládacího prvku [,{Size, DPI, Margin, Orientation, ExpandContainers}])

  • Název obrazovky nebo ovládacího prvku – povinné. Obrazovka nebo ovládací prvek obsahující obsah, který se má použít ke generování PDF. Podporované ovládací prvky: Vertical Gallery, Vertical Layout Container, Horizontal Layout Container, Container, Screen.

  • Size – volitelné. Řídí rozměry generovaného PDF. Výchozí hodnota závisí na národním prostředí uživatele aplikace; Letter pro USA a Kanadu a A4 pro ostatní národní prostředí.

  • DPI – volitelné. Řídí škálování/rozlišení generovaného PDF. Musí být hodnota větší než 0. Obsah přesahující prostor povolený zadanými okraji může mít za následek vyšší efektivní DPI. Výchozí hodnota je 96.

  • Margin – volitelné. Řetězec určující velikost prostoru vyhrazeného mezi obsahem a vnějším okrajem generovaného PDF. Každý okraj vygenerovaného PDF (nahoře, vpravo, dole, vlevo) může podporovat jinou hodnotu. Podporované jednotky měření pro tuto hodnotu zahrnují in, cm, mm, pt a px. Výchozí hodnota je 0,5 palce (12,7 mm) pro všechny okraje.

  • Orientation – volitelné. Určuje, zda má vygenerovaný soubor PDF orientaci na výšku (vertikální), nebo na šířku (horizontální). Výchozí hodnota je na šířku (vertikální).

  • ExpandContainers – volitelné. Logický. Řídí, zda se určité kontejnery s obsahem, který překračuje jejich přidělenou velikost, rozbalí, aby zobrazily veškerý obsah ve vygenerovaném PDF. Mezi ovlivněné ovládací prvky patří obrazovky, kontejnery, vertikální a horizontální kontejnery, vertikální galerie s pevnou výškou (ne vnořené), formuláře a rolovací ovládací prvky plátna. Výchozí hodnota je false.

Příklady

Vzorec Description Výsledek
PDF(Screen1) Vygeneruje objekt PDF s výchozím nastavením. Z viditelného obsahu Screen1 se vytvoří objekt PDF.
PDF(Container1, {Size: A3}) Vygeneruje objekt PDF s velikostí papíru nastavenou na A3. Z viditelného obsahu Container1 se vytvoří objekt PDF o velikosti A3.
PDF(Screen1, {DPI: 72, Margin: "25mm", Orientation: "Landscape"}) Vygeneruje objekt PDF s rozlišením (DPI) nastaveným na 72, okrajem nastaveným na 25 milimetrů a orientací nastavenou na šířku (horizontální). Z viditelného obsahu na Screen1 se vytvoří PDF se zadaným DPI, okrajem a orientací ve výchozí velikosti (v závislosti na národním prostředí).
PDF(Screen1, {ExpandContainers: true}) Vygeneruje objekt PDF s rozbalenými příslušnými ovládacími prvky. Vytvoří se PDF, kde se rozbalí všechny kontejnery/galerie s větším obsahem, než je viditelný, aby se zobrazil veškerý obsah ve vygenerovaném PDF.

Známá omezení

  • Některé ovládací prvky nejsou v současné době podporovány. Patří mezi ně grafy, dlaždice Power BI, mapa a některé konfigurace ovládacích prvků PCF třetí strany.

  • Vnořené galerie nejsou podporovány.

  • U některých písem se ve vygenerovaném PDF nemusejí objevit jiné typy písma než latinka, tloušťky a styly písem, jako je tučné písmo a kurzíva.

  • Vytváření vyplnitelných PDF není podporováno.