pdfviewer — u_pbt_pdfviewer #

← Komponentenreferenz · Inhalt des Handbuchs

Integrierter PDF-Betrachter: zeigt ein lokales oder im Web veröffentlichtes Dokument direkt in Ihrem Fenster an, mit Seitennavigation, Zoom und Druckfunktion.

▶ Live ansehen — Demoanwendung, Kachel PDF viewer: die Vorschau, der zugehörige Code und diese Seite, nebeneinander.

Auf einen Blick #

Die Komponente ersetzt das klassische „PDF in eine temporäre Datei speichern und dann ShellExecute aufrufen“: Das Dokument bleibt in Ihrer Anwendung, und der Benutzer verlässt nie den aktuellen Bildschirm.

Schnellstart #

// open-Event des Fensters : ein auf der Festplatte vorhandenes Dokument anzeigen
uo_pdf.is_source = "C:\factures\FA-2026-0142.pdf"

// ue_load_completed-Event von uo_pdf : (string as_source)
uo_status.of_panel(/*key*/ "main").is_text = "Dokument angezeigt"

Das ist alles: is_source zu setzen genügt, um das Dokument zu laden und anzuzeigen.

Eigenschaften #

Methoden #

Events #

Warum ein Dokument nicht angezeigt wird #

as_reason von ue_load_failed ist eine dieser Konstanten von u_pbt_pdfviewer. Ein PDF wird so erkannt: Eine lokale Datei hat die Endung .pdf und beginnt mit der Signatur %PDF-; ein entferntes Dokument wird mit dem Typ application/pdf ausgeliefert (dem einzigen, den die Engine an ihren Betrachter übergibt); eine data:-Adresse kündigt application/pdf an.

Was der Benutzer ohne eine einzige Zeile Code tun kann #

Der Betrachter zeigt seine integrierte Symbolleiste über dem Dokument an. Sie müssen nichts programmieren: Sie wird vom System bereitgestellt und lokalisiert.

Die Tastenkürzel des Browsers — Strg+F, Strg+P, Strg + Mausrad — sind in allen Komponenten abgeschaltet, auch in dieser: Verwenden Sie die Schaltflächen der Leiste des Betrachters.

Was der Betrachter nicht mitteilt #

Der Betrachter ist der in die Web-Engine integrierte: nichts zu installieren, Drucken, Suche, PDF-Formulare und Vollbild inbegriffen. Im Gegenzug teilt er Ihrer Anwendung nichts mit: weder die angezeigte Seite noch die Seitenzahl, weder den tatsächlichen Zoom noch den markierten Text, und die Suche lässt sich nicht per Code steuern. ii_page und ii_zoom sagen, wo das Dokument geöffnet wird, nicht wo sich der Benutzer befindet. Das ist eine bewusste Entscheidung für 4.0; eine skriptfähige Darstellung bräuchte eine externe Bibliothek.

Beispiele #

Ein lokales Dokument öffnen #

// Absoluter Pfad, oder relativ zum Verzeichnis der Anwendung
uo_pdf.is_source = "doc\conditions-generales.pdf"

Ein im Web veröffentlichtes Dokument öffnen #

// Eine Webadresse wird genau wie eine lokale Datei geladen
uo_pdf.is_source = "https://www.monsite.fr/tarifs/catalogue-2026.pdf"

Eine Internetverbindung ist selbstverständlich erforderlich; das Laden erfolgt asynchron, ue_load_completed meldet Ihnen das Ende.

Das PDF anzeigen, das eine DataWindow gerade erzeugt hat #

// Local variables
string ls_file

// Eine Datei pro Tag, im temporaeren Ordner
ls_file = "C:\temp\report_" + String(Today(), "yyyymmdd") + ".pdf"

// Die DataWindow erzeugt die Datei...
dw_report.SaveAs(ls_file, PDF!, false)

// ...und der Betrachter zeigt sie sofort an
uo_pdf.is_source = ls_file

Nach der Neuerzeugung der Datei aktualisieren #

// Die Datei wurde am selben Ort neu geschrieben : neu laden, ohne is_source anzufassen
uo_pdf.of_refresh()

Mehrere Dokumente nacheinander im selben Betrachter anzeigen #

// ue_row_changed-Event von dw_list : den Anhang der aktuellen Zeile anzeigen
string ls_pdf

// Der Pfad des PDF der aktuellen Zeile
ls_pdf = dw_list.GetItemString(dw_list.GetRow(), "pdf_path")

// Ohne Anhang wird der Betrachter geleert ; sonst zeigt er ihn an
if ls_pdf = "" then
    uo_pdf.of_reset()          // kein Anhang : leerer Betrachter
else
    uo_pdf.is_source = ls_pdf
end if

Das Ende des Ladevorgangs verfolgen #

// ue_load_completed-Event von uo_pdf : (string as_source)
uo_wait.Hide()

// of_print druckt das angezeigte Dokument
uo_print_button.ib_enabled = true

Sagen, warum das Dokument nicht da ist #

// ue_load_failed-Event von uo_pdf : (string as_source, string as_reason)
uo_wait.Hide()
choose case as_reason
	case uo_pdf.REASON_NOT_FOUND
		uo_status.of_panel(/*key*/ "main").is_text = "Dokument nicht gefunden: " + as_source
	case uo_pdf.REASON_NOT_PDF
		uo_status.of_panel(/*key*/ "main").is_text = "Diese Datei ist kein PDF"
	case else
		uo_status.of_panel(/*key*/ "main").is_text = "Dokument nicht verfuegbar (" + as_reason + ")"
end choose

Einen Link des Dokuments anderswo öffnen #

// ue_link_clicked-Event von uo_pdf : (string as_url)
// Der Betrachter bleibt beim Dokument : der Link oeffnet sich im Browser des Fensters
uo_web.is_address = as_url

Das Dokument drucken #

// clicked der Schaltflaeche Drucken : die Vorschau des PDF-Betrachters, auf dem Dokument selbst
if uo_pdf.of_print() = -4 then
	uo_status.of_panel(/*key*/ "main").is_text = "Kein Dokument zu drucken"
end if

Anzeigen, ohne Speichern oder Drucken zu erlauben #

// Ein vertrauliches Dokument : weder Speichern noch Drucken in der Leiste des Betrachters
uo_pdf.ib_allow_save = false
uo_pdf.ib_allow_print = false
uo_pdf.is_source = is_current_document

Setzen Sie sie vor is_source: Jede Änderung lädt das Dokument neu. Das ist kein Schutz: Die Datei bleibt auf der Festplatte lesbar, und of_print druckt weiterhin.

Vorschau in einer Registerkarte, neben der Eingabe #

// open-Event : der Betrachter belegt eine Registerkartenseite, die Eingabe die andere
uo_tab.of_add_page(/*key*/ "entry",  /*title*/ "Eingabe",   /*page*/ uo_page_entry)
uo_tab.of_add_page(/*key*/ "preview",  /*title*/ "Vorschau",   /*page*/ uo_page_preview)

// Der Betrachter wird wie jedes andere Steuerelement in uo_page_preview abgelegt
uo_pdf.is_source = is_current_document

Die Komponente lässt sich ohne besondere Vorkehrungen in einer tab oder in einem dockcontainer-Panel hosten.

Die Datei vor der Anzeige prüfen #

// Local variables
string ls_path

// Die Datei der angezeigten Rechnung
ls_path = "C:\factures\" + is_number + ".pdf"

// Keine Datei, nichts zu zeigen : den Betrachter leeren, statt das vorherige Dokument stehen zu lassen
if not FileExists(ls_path) then
    uo_pdf.of_reset()
    uo_status.of_panel(/*key*/ "main").is_text = "Rechnung nicht gefunden"
    return
end if

// Sonst wird die Rechnung angezeigt
uo_pdf.is_source = ls_path

Akzeptierte Formate und Pfade #

Diese Komponente unterstützt ausschließlich PDF: Alles andere wird abgelehnt und über ue_load_failed (REASON_NOT_PDF) gemeldet. Für ein Bild verwenden Sie picture; für eine HTML-Seite webbrowser.

Best Practices #

• Beobachten Sie ue_load_failed: Ein ungültiger Pfad, eine Datei, die kein PDF ist, oder eine nicht erreichbare Website wird dort mit ihrem Grund gemeldet, und der Betrachter bleibt leer.
• Rufen Sie of_reset() auf, wenn kein Dokument mehr angezeigt werden soll (Wechsel zu einer Zeile ohne Anhang): sonst bleibt das vorherige Dokument sichtbar.
• of_refresh() ist der Weg, eine am selben Pfad neu erzeugte Datei anzuzeigen: Es liest die Datei erneut, ohne die Einstellungen anzutasten. Die Scrollposition bleibt nicht erhalten — der Betrachter beginnt wieder bei ii_page.
• Jede Änderung von ii_page, ii_zoom, is_fit oder ib_viewer_toolbar lädt das Dokument neu (der Betrachter liest seine Einstellungen nur beim Laden) und löst ue_load_completed erneut aus: Setzen Sie sie vor is_source, damit nur einmal geladen wird.
• Sehen Sie eine Wartanzeige für entfernte oder umfangreiche Dokumente vor und blenden Sie sie bei ue_load_completed und bei ue_load_failed aus.
• Geben Sie der Komponente eine großzügige Fläche (mindestens die Hälfte des Fensters): Die integrierte Symbolleiste und das Dokument brauchen Platz, um lesbar zu bleiben.
• Um eine Webseite statt eines PDF anzuzeigen, verwenden Sie webbrowser; für ein Bild picture.

Vom gemeinsamen Sockel geerbt #

Diese Mitglieder gibt es bei jeder visuellen Komponente — sie sind nicht dieser eigen. Sie werden einmal in den übergreifenden Kapiteln beschrieben; diese Tabelle sagt nur, wo man sie liest.

Zwei Helfer werden nicht geerbt: of_icon und of_escape_markup liegen auf n_pbt_utils. Deklarieren Sie eines — n_pbt_utils lnv_utils, nichts zu erzeugen — und rufen Sie sie darauf auf.

← Komponentenreferenz · Inhalt des Handbuchs