De functie PDF (experimenteel)

Van toepassing op: Canvas-apps Modelgestuurde apps

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Exporteer inhoud vanuit het huidige scherm naar een object voor gebruik in meerdere scenario's.

Belangrijk

Omschrijving

Met de PDF-functie kunt u een scherm of delen van een scherm selecteren om te exporteren naar een PDF-object (blob).

Verschillende configuratieopties maken verschillende resultaten mogelijk voor de resulterende gegenereerde PDF.

Belangrijk

  • PDF-generatie vindt plaats op het apparaat waarop de app wordt uitgevoerd. Verschillende apparaten, zoals desktopcomputers en mobiele apparaten, hebben verschillende capaciteiten wanneer u een PDF genereert.
  • Het genereren van een PDF met een uitzonderlijk groot bestand kan ertoe leiden dat de app crasht. Dit is afhankelijk van de capaciteit van het apparaat waarop u de app uitvoert. Houd rekening met de grootte en het aantal afbeeldingen en hoeveel gegevens u in de gegenereerde PDF wilt opnemen, met name voor apps die bedoeld zijn voor gebruik op een mobiel apparaat.

Notitie

  • U kunt alleen een PDF genereren van inhoud die aanwezig is op het scherm waarop u de PDF-functie hebt aangeroepen. Als u bijvoorbeeld de PDF-functie op scherm twee hebt toegevoegd, kan alleen de inhoud van scherm twee worden opgenomen in de gegenereerde PDF.

Syntaxis

PDF(Naam van scherm of besturingselement [,{Size, DPI, Margin, Orientation, ExpandContainers}])

  • Naam van scherm of besturingselement : vereist. Het scherm of besturingselement dat de inhoud bevat die moet worden gebruikt om de PDF te genereren. Ondersteunde besturingselementen: Verticale galerie, Verticale indeling container, Horizontale indeling container, Container, Scherm.

  • Size –: optioneel. Bepaalt de afmetingen van de gegenereerde PDF. De standaardwaarde is afhankelijk van de landinstelling van de app-gebruiker; Letter voor de VS en Canada en A4 voor andere landinstellingen.

  • DPI: optioneel. Bepaalt de schaling/resolutie van de gegenereerde PDF. Moet een waarde groter dan 0 zijn. Inhoud die de toegestane ruimte overschrijdt met de opgegeven marges, kan resulteren in een hogere effectieve DPI. De standaardwaarde is 96.

  • Margin –: optioneel. Een tekenreeks die de grootte aangeeft van de ruimte die is gereserveerd tussen de inhoud en de buitenrand van de gegenereerde PDF. Elke marge van de gegenereerde PDF (boven, rechts, onder, links) kan een andere waarde ondersteunen. Ondersteunde meeteenheden voor deze waarde zijn in, cm, mm, pt en px. De standaardwaarde is 0,5 inch (12,7 mm) voor alle marges.

  • Orientation –: optioneel. Bepaalt of de gegenereerde PDF een staande (verticale) of liggende (horizontale) oriëntatie heeft. De standaardwaarde is staand (verticaal).

  • ExpandContainers –: optioneel. Booleaans. Bepaalt of bepaalde containers met inhoud die de toegewezen grootte overschrijdt, worden uitgebreid om alle inhoud in de gegenereerde PDF weer te geven. Beïnvloede besturingselementen omvatten schermen, containers, verticale en horizontale containers, verticale galerieën met vaste hoogte (niet genest), formulieren en schuifbare canvasbesturingselementen. De standaardwaarde is false.

Voorbeelden

Formule Omschrijving Resultaat
PDF(Scherm1) Genereert een PDF-object met de standaardinstellingen. Er wordt een PDF-object gemaakt van de zichtbare inhoud van Scherm1.
PDF(Container1, {Size: A3}) Genereert een PDF-object met het papierformaat ingesteld op A3. Op basis van de zichtbare inhoud van Container1 wordt een PDF-object van A3-formaat gemaakt.
PDF(Screen1, {DPI: 72, Margin: "25mm", Orientation: "Landscape"}) Genereert een PDF-object met de resolutie (DPI) ingesteld op 72, de marge ingesteld op 25 millimeter en de oriëntatie ingesteld op liggend (horizontaal). Een PDF met de opgegeven DPI, marge en richting wordt gemaakt in de standaardgrootte (afhankelijk van de landinstelling) op basis van de zichtbare inhoud van Scherm1.
PDF(Screen1, {ExpandContainers: true}) Genereert een PDF-object met de toepasselijke besturingselementen uitgevouwen. Er wordt een PDF gemaakt waarbij containers/galerieën met meer inhoud dan zichtbaar is, worden uitgevouwen om alle inhoud in de gegenereerde PDF weer te geven.

Bekende beperkingen

  • Bepaalde besturingselementen worden momenteel niet ondersteund. Deze omvatten grafieken, Power BI-tegel, kaart en sommige configuraties van PCF-besturingselementen van derden.

  • Geneste galerieën worden niet ondersteund.

  • Niet-Latijnse scripttypen en tekengewichten en stijlen, zoals vet en cursief, verschijnen mogelijk niet in de gegenereerde PDF voor sommige lettertypen.

  • Het maken van invulbare PDF's wordt niet ondersteund.