PDF-Anzeige-Steuerelement in Power Apps (in der Prüfung)
Ein in der Prüfung befindliches Steuerelement, das den Inhalt einer PDF-Datei anzeigt.
Beschreibung
Zeigen Sie Text, Grafiken und anderen Inhalt in einer PDF-Datei an, indem Sie diese Art von Steuerelement hinzufügen und seine Dokument-Eigenschaft auf die URL der Datei festlegen, die Sie anzeigen möchten. Verwenden Sie dabei doppelte Anführungszeichen.
Einschränkungen
Das PDF-Viewer-Steuerelement unterstützt nur PDF-Dateien, die der PDF32000-Spezifikation entsprechen.
Die Sicherheitsarchitektur von Power Apps erfordert, dass der PDF-Viewer nur HTTPS-Links unterstützt und nicht HTTP.
Die Document-Eigenschaft muss direkt mit der PDF-Datei verknüpft sein. Serverumleitungen oder HTML-Ansichten des Dokuments werden nicht unterstützt.
Die Datei muss anonym und ohne Authentifizierung zugänglich sein.
Sie können ein PDF-Dokument nicht in Ihrer App anzeigen, wenn sich das Dokument auf einem Server befindet, der über restriktive CORS-Einstellungen (Cross-Origin Resource Sharing) verfügt. Um dieses Problem zu beheben, muss der Server, der PDF-Dokumente hostet, Cross-Origin-Anfragen von powerapps.com zulassen.
Eingebettete Objekte wie Skripts und Schaltflächen werden nicht ausgeführt.
Das Drucken des Dokuments wird nicht unterstützt.
App-Benutzer können diese Einschränkungen umgehen, indem sie PDF-Dokumente in einem externen Browser öffnen, wenn das Steuerelement ein Dokument nicht öffnen kann. Diese Option ist auch im Systemmenü für alle externen Dokumente verfügbar.
Wichtige Eigenschaften
Document – Gibt die, in doppelten Anführungszeichen gesetzte, URL der PDF-Datei an.
Zusätzliche Eigenschaften
ActualZoom : Der tatsächliche Zoom des Steuerelements, der sich von dem mit der Eigenschaft Zoom angeforderten Zoom unterscheiden kann.
BorderColor - Die Farbe des Rahmens eines Steuerelements.
BorderStyle - Legt fest, ob der Rahmen eines Steuerelements Durgehend, Gestrichelt, Gepunktet oder Keine ist.
BorderThickness - Die Linienstärke des Rahmens eines Steuerelements.
CurrentFindText – Gibt den aktuellen Suchbegriff an, der verwendet wird.
CurrentPage – Gibt die Anzahl der Seiten in einer PDF-Datei an, die tatsächlich angezeigt wird.
DisplayMode - Legt fest, ob das Steuerelement Benutzereingaben zulässt (Bearbeiten), ob nur Daten angezeigt werden (Anzeigen) oder ob das Steuerelement deaktiviert ist (Deaktiviert).
DisabledBorderColor: Die Farbe des Steuerelementrahmens, wenn die DisplayMode-Eigenschaft des Steuerelements auf Deaktiviert festgelegt ist.
Fill - Die Hintergrundfarbe eines Steuerelements.
FindNext – Sucht nach der nächsten Instanz von FindText im Dokument.
FindPrevious – Sucht nach der vorherigen Instanz von FindText im Dokument.
FindText – Gibt den Suchbegriff an, der im Dokument gesucht.
Height - Die Entfernung zwischen dem oberen und unteren Rand eines Steuerelements.
HoverBorderColor – Die Rahmenfarbe eines Steuerelements, wenn der Benutzer den Mauszeiger über das Steuerelement hält.
OnSelect – Auszuführende Aktionen, wenn der Benutzer auf ein Steuerelement tippt oder es auswählt.
OnStateChange – Auszuführende Aktionen, wenn sich der Zustand des Steuerelements ändert.
PaddingBottom – Der Abstand zwischen dem Text in einem Steuerelement und dem unteren Rand des Steuerelements.
PaddingLeft – Der Abstand zwischen dem Text eines Steuerelements und dem linken Rand des Steuerelements.
PaddingRight – Der Abstand zwischen dem Text eines Steuerelements und dem rechten Rand des Steuerelements.
PaddingTop – Der Abstand zwischen dem Text eines Steuerelements und dem oberen Rand des Steuerelements.
Page – Gibt die Nummer der Seite an, die Sie anzeigen möchten.
PageCount – Gibt die Anzahl der Seiten in einem Dokument an.
PressedBorderColor : Die Farbe des Steuerelementrahmens, wenn der Benutzer auf das Steuerelement tippt oder es auswählt.
ShowControls –– Gibt beispielsweise an, ob für einen Audio- oder Videoplayer eine Schaltfläche für die Wiedergabe und ein Lautstärkeregler und für ein Stift-Steuerelement Symbole zum Zeichnen oder Löschen angezeigt werden.
Tooltip - Erklärender Text, der angezeigt wird, wenn der Benutzer auf ein Steuerelement zeigt.
Visible - Gibt an, ob ein Steuerelement angezeigt wird oder ausgeblendet ist.
Width - Der Abstand zwischen dem linken und rechten Rand eines Steuerelements.
X – Der Abstand zwischen dem linken Rand eines Steuerelements und dem linken Rand des übergeordneten Containers (vom Bildschirm, wenn kein übergeordneter Container vorhanden ist).
Y – Der Abstand zwischen dem oberen Rand eines Steuerelements und dem oberen Rand des übergeordneten Containers (Vom Bildschirm, wenn kein übergeordneter Container vorhanden ist).
Zoom: gibt den Prozentsatz an, mit dem ein Bild einer Kamera vergrößert wird (oder die Ansicht einer Datei in einem PDF-Viewer).
Tastenkombinationen
- J - Nächste Seite
- K - Vorherige Seite
- N - Nächste Seite
- R - Alle Seiten um 90° im Uhrzeigersinn drehen
Beispiel
Fügen Sie ein Steuerelement des Typs PDF-Anzeige hinzu, und legen Sie seine Document-Eigenschaft (in doppelten Anführungszeichen) auf die URL einer PDF-Datei fest, wie im folgenden Beispiel gezeigt:
"https://blog.mozilla.org/security/files/2015/05/HTTPS-FAQ.pdf"
Das Steuerelement zeigt die PDF-Datei.
Möchten Sie wissen, wie Sie ein Steuerelement hinzufügen und konfigurieren?
Richtlinien für Barrierefreiheit
Es werden nicht alle Barrierefreiheitsfunktionen von PDF-Dokumenten unterstützt, da sich der PDF-Anzeige noch in der Prüfungsphase befindet. Daher sollte ShowControls auf TRUE festgelegt sein, damit Benutzer das Dokument in einer externen Anwendung öffnen können.
Erfahren Sie, wie Sie mit den Standards Web Content Accessibility Guidelines (WCAG) 2.0 und PDF/UA barrierefreie PDF-Dokumente erstellen.
Screenreadersupport
Erwägen Sie das Hinzufügen einer Überschrift mit einem Label, wenn das PDF-Dokument keinen Titel hat. Der Titel kann direkt vor dem PDF-Anzeige platziert werden.
Hinweis
Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)
Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).