Document viewer

Verwenden Sie das Steuerelement der Dokumentanzeige , um ein Dokument zu rendern und es inline in Ihrer App anzuzeigen. Sie können beispielsweise das Steuerelement Dokumentansicht verwenden, um ein Rechnungsdokument oder einen Beleg anzuzeigen, der sich in verschiedenen Quellen befinden kann, z. B. in Speicher-Buckets, Entitäten oder öffentlichen Links.

Das Dokumentanzeige- Steuerelement unterstützt keine Dateien auf der lokalen Maschine. Sie müssen mithilfe einer URL, eines Speicher-Buckets oder einer Entität auf Remote-Dokumente verweisen.

Stellen Sie beim Zuweisen der Datei zu einer App-Variablen sicher, dass die Variable vom Typ IResource ist.

Wenn Sie nur ein Bild anzeigen möchten, wird empfohlen, das Bildsteuerelement zu verwenden.

Wichtig:

Die Dokumentanzeige verwendet einen integrierten PDF.js-Viewer, der in allen Browsern konsistent funktioniert. Es ist keine Browserkonfiguration erforderlich. Beim Laden von PDFs von externen Dateiservern muss der Server Anforderungen zwischen verschiedenen Quellen unterstützen. Wenn CORS nicht aktiviert ist, kann der integrierte PDF.js-Viewer das Dokument nicht rendern.

Verwenden der Dokumentanzeige mit einem Speicher-Bucket

Wenn Sie mit einem Speicher-Bucket in Ihrer App arbeiten, muss die Eigenschaft Quelle eines Dokumentansichtssteuerelements eine IResource -Variable sein:

1. Fügen Sie Ihrer App eine Regel aus Speicher-Bucket herunterladen hinzu.
2. Binden Sie eine IResource -Variable an die Regel Aus Speicher-Bucket herunterladen .
3. Binden Sie dieselbe IResource -Variable an die Eigenschaft Quelle der Dokumentanzeige.

Arbeiten mit IResource

Wenn Sie eine Datei als ILocalResource erhalten, wird sie automatisch in eine IResource konvertiert, indem Folgendes verwendet wird:

JobAttachment.fromResource(file) // file is a ILocalResource

Wichtig:

Die folgenden Funktionen sind veraltet und sollten nicht mehr verwendet werden:

• .toLocalResource
• .toAppsFile

Seitennavigation

Sie können programmatisch zu einer bestimmten Seite in der Dokumentanzeige navigieren, indem Sie Folgendes verwenden:

appsFile.NavigateToPage(pageNumber)

Allgemein

• Quelle – Die Quelle des Dokuments, das Sie anzeigen möchten. Die unterstützten Dateitypen sind PDF-Dokumente und Bilder (JPEG, PNG, BMP, GIF und WEBP).
• Ausgeblendet – Bei „true“ wird das Steuerelement während der Runtime ausgeblendet.
• Deaktiviert – Bei „true“ wird das Steuerelement während der Laufzeit deaktiviert.

Events

Keine Ereignisse.

Stil

• Ausrichtung von Steuerelementen – Erbt standardmäßig die übergeordnete Ausrichtung. Eine andere Ausrichtung als die übergeordnete kann festgelegt werden. Um die Standardausrichtung wiederherzustellen, heben Sie die Markierung der überschriebenen Optionen auf.
  Hinweis:

  Die Ausrichtung hängt vom Layout ab, das für das übergeordnete Element ausgewählt wurde (Vertikal vs. Horizontal).

• Rahmen – Der Rahmen für das Steuerelement. Rahmenstärke, Farbe und Radius können konfiguriert werden.
• Seitenrand – Der Seitenrand des Steuerelements. Standardmäßig ist ein Seitenrand von 4px festgelegt. Die Randeigenschaften Oben/Unten und Links/Rechts werden kombiniert. Diese Eigenschaften können mit der Schaltfläche Link rechts neben dem Abschnitt Seitenrand getrennt werden.
• Größe – Die Breite und Höhe des Steuerelements. Standardmäßig ist die Größe auf auto festgelegt, also 320 x 410px. Um Mindest- oder Höchstwerte festzulegen, wählen Sie das Drei-Punkte-Symbol (…) aus.

VB-Eigenschaften

VB-Eigenschaft	Datentyp	Beschreibung
Source	IResource	Die aktuell angezeigte Quelldatei.
Value	IResource	Wert, der vom Steuerelement der Dokumentansicht angefügt oder ausgegeben wurde.
Hidden	Boolescher	Bei „true“ wird das Steuerelement zur Laufzeit ausgeblendet.
Disabled	Boolescher	Bei „true“ wird das Steuerelement zur Laufzeit deaktiviert.