Freigeben über

Funktion „PDF“ (experimentell)

  • Artikel

Gilt für: Canvas-Apps Modellgesteuerte Apps

[Dieser Artikel ist Teil der Dokumentation zur Vorabversion und kann geändert werden.]

Exportiert Inhalte aus dem aktuellen Bildschirm in ein Objekt zur Verwendung in mehreren Szenarien.

Wichtig

Beschreibung des Dataflows

Mit der PDF-Funktion können Sie einen Bildschirm oder Teile eines Bildschirms für den Export in ein PDF-Objekt (Blob) auswählen.

Unterschiedliche Konfigurationsoptionen ermöglichen unterschiedliche Ergebnisse für das resultierende generierte PDF.

Wichtig

  • Die PDF-Generierung erfolgt auf dem Gerät, auf dem die App ausgeführt wird. Verschiedene Geräte wie Desktop-Computer und mobile Geräte haben unterschiedliche Kapazitäten, wenn Sie ein PDF generieren.
  • Das Generieren einer PDF-Datei mit einer außergewöhnlich großen Dateigröße kann zum Absturz der App führen. Dies hängt von der Kapazität des Geräts ab, auf dem Sie die App ausführen. Beachten Sie die Größe und Anzahl der Bilder und wie viele Daten Sie in das generierte PDF aufnehmen möchten, insbesondere bei Apps, die für die Verwendung auf einem mobilen Gerät vorgesehen sind.

Notiz

  • Sie können ein PDF nur aus Inhalten generieren, die auf dem Bildschirm vorhanden sind, auf dem Sie die PDF-Funktion aufgerufen haben. Wenn Sie beispielsweise die PDF-Funktion auf Bildschirm zwei hinzugefügt haben, kann nur der Inhalt auf Bildschirm zwei in das generierte PDF aufgenommen werden.

Syntax

PDF(Bildschirm- oder Steuerelementname [,{Größe, DPI, Rand, Ausrichtung, ExpandContainers}])

  • Bildschirm- oder Steuerelementname – Erforderlich. Der Bildschirm oder das Steuerelement mit dem Inhalt, der zum Generieren der PDF-Datei verwendet werden soll. Unterstützte Steuerelemente: Vertikale Galerie, Vertikaler Layout-Container, Horizontaler Layout-Container, Container, Bildschirm.

  • Größe – Optional. Steuert die Abmessungen der generierten PDF-Datei. Der Standardwert hängt vom Gebietsschema des App-Benutzers ab; Letter für die USA und Kanada und A4 für andere Länder.

  • DPI – Optional. Steuert die Skalierung/Auflösung der generierten PDF-Datei. Muss einen Wert größer als 0 aufweisen. Inhalte, die den durch die angegebenen Ränder zulässigen Platz überschreiten, können zu einer höheren effektiven DPI führen. Der Standardwert ist 96.

  • Rand – Optional. Eine Zeichenfolge, die die Größe des zwischen dem Inhalt und dem äußeren Rand der generierten PDF-Datei reservierten Platzes angibt. Jeder Rand des generierten PDF (oben, rechts, unten, links) kann einen anderen Wert unterstützen. Unterstützte Maßeinheiten für diesen Wert sind Zoll, cm, mm, pt und px. Der Standardwert ist 0,5 Zoll (12,7 mm) für alle Ränder.

  • Ausrichtung – Optional. Steuert, ob die generierte PDF-Datei im Hochformat (vertikal) oder im Querformat (horizontal) ausgerichtet ist. Der Standardwert ist Porträt (vertikal).

  • ExpandContainers – Optional. Boolesch. Steuert, ob bestimmte Container mit Inhalten, die ihre zugewiesene Größe überschreiten, erweitert werden, um den gesamten Inhalt im generierten PDF anzuzeigen. Zu den betroffenen Steuerelementen gehören Bildschirme, Container, vertikale und horizontale Container, vertikale Galerien mit fester Höhe (nicht verschachtelt), Formulare und scrollbare Canvas-Steuerelemente. Der Standardwert ist „falsch“.

Beispiele

Formel Beschreibung Ergebnis
PDF(Bildschirm1) Erzeugt ein PDF-Objekt mit den Standardeinstellungen. Aus den sichtbaren Inhalten von Screen1 wird ein PDF-Objekt erstellt.
PDF(Container1, {Größe: A3}) Erzeugt ein PDF-Objekt mit dem auf A3 eingestellten Papierformat. Aus dem sichtbaren Inhalt von Container1 wird ein A3-großes PDF-Objekt erstellt.
PDF(Bildschirm1, {DPI: 72, Rand: „25 mm“, Ausrichtung: „Querformat“}) Erzeugt ein PDF-Objekt mit einer auf 72 eingestellten Auflösung (DPI), einem auf 25 Millimeter eingestellten Rand und einer auf Querformat (horizontal) eingestellten Ausrichtung. Aus dem sichtbaren Inhalt auf Screen1 wird eine PDF-Datei mit den angegebenen DPI-Werten, Rändern und Ausrichtungen in der Standardgröße (abhängig vom Gebietsschema) erstellt.
PDF(Bildschirm1, {ExpandContainers: true}) Erzeugt ein PDF-Objekt mit erweiterten zutreffenden Steuerelementen. Es wird ein PDF erstellt, in dem alle Container/Galerien mit mehr Inhalt als sichtbar erweitert werden, um den gesamten Inhalt im generierten PDF anzuzeigen.

Bekannte Einschränkungen

  • Bestimmte Steuerelemente sind derzeit nicht unterstützt. Dazu gehören Diagramme, Power BI-Kachel, Karte und einige Konfigurationen von PCF-Steuerelementen von Drittanbietern.

  • Geschachtelte Gallerien werden nicht unterstützt.

  • Nicht-lateinische Schrifttypen und Schriftstärken und -stile wie Fett und Kursiv erscheinen möglicherweise nicht in der generierten PDF-Datei für einige Schriftarten.

  • Das Erstellen von ausfüllbaren PDFs wird nicht unterstützt.