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 (is_find hebt beim Öffnen einen Text hervor, mehr nicht). ii_page und ii_zoom sagen, wo das Dokument geöffnet wird, nicht wo sich der Benutzer befindet. Ein kennwortgeschütztes PDF: Der Betrachter fragt den Benutzer selbst nach dem Kennwort, Ihre Anwendung kann es ihm nicht übergeben. Das ist eine bewusste Entscheidung; 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 #

// rowfocuschanged-Event von dw_list : (long currentrow)
// Local variables
string ls_pdf

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

// Ohne Anhang wird der Betrachter geleert (Einstellungen bleiben) ; sonst zeigt er ihn an
if ls_pdf = "" then
	uo_pdf.is_source = ""
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: Das Dokument wird nur einmal geladen. Jeder Betrachter behält seine eigene Einstellung. 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.is_source = ""
    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

Ein aus der Datenbank gelesenes PDF anzeigen (Blob) #

// Local variables
blob lblb_pdf

// Die in der Datenbank gespeicherte Rechnung, in einen Blob gelesen
SELECTBLOB pdf_file INTO :lblb_pdf FROM invoice WHERE invoice_no = :is_number USING SQLCA;

// Direkt aus dem Speicher angezeigt : keine temporaere Datei, gleich welcher Groesse
if SQLCA.SQLCode = 0 then
	uo_pdf.of_load_blob(/*pdf*/ lblb_pdf, /*name*/ "invoice-" + is_number + ".pdf")
end if

Der übergebene Name kommt in is_source und in ue_load_completed zurück; der Blob wird durch das nächste Dokument oder durch of_reset freigegeben.

Eine bestimmte Zeile des Dokuments zeigen #

// Der Betrachter oeffnet sich auf der ersten Stelle dieses Textes, hervorgehoben
uo_pdf.is_find = "Delivery and assembly"
uo_pdf.is_source = "C:\factures\FA-2026-0142.pdf"

Auf einem Kapitel öffnen, Lesezeichen sichtbar #

// Die Seitenleiste mit ihren Lesezeichen, geoeffnet auf dem Kapitel "prices" des Katalogs
uo_pdf.ib_navigation_pane = true
uo_pdf.is_destination = "prices"
uo_pdf.is_source = "doc\catalogue-2026.pdf"

Der Name eines Ziels ist der, den das Werkzeug geschrieben hat, das das PDF erzeugt hat: Ihr Dokumentgenerator kennt ihn.

Ein Dokument hinter einem Token oder als octet-stream ausgeliefert #

// Local variables
long ll_status
string ls_file

// Der restclient (inv_rest, beim Oeffnen des Fensters vorbereitet) sendet das Token und laedt die Datei herunter
ls_file = "C:\temp\invoice-4152.pdf"
ll_status = inv_rest.of_download(/*url*/ "/orders/4152/invoice.pdf", /*path*/ ls_file)

// Dann zeigt der Betrachter die Datei an, gleich welchen Typ der Server angekuendigt hat
if ll_status = 200 then
	uo_pdf.is_source = ls_file
end if

Der Betrachter der Engine kann weder ein Token senden noch eine application/octet-stream-Antwort anzeigen (REASON_AUTH, REASON_NOT_PDF): Der restclient übernimmt das für ihn.

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.
• Um den Betrachter zu leeren (Wechsel zu einer Zeile ohne Anhang), setzen Sie is_source = "": sonst bleibt das vorherige Dokument sichtbar. of_reset() leert ihn ebenfalls, setzt aber zusätzlich alle Einstellungen auf ihren Standard zurück — Speichern und Drucken inbegriffen.
• 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_zoom, is_fit, ib_viewer_toolbar, ib_navigation_pane, is_destination, is_find, ib_allow_save oder ib_allow_print 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. Derselbe Wert erneut gesetzt lädt nichts neu. ii_page, gesetzt während ein Dokument angezeigt wird, gilt für dieses Dokument: Um ein anderes auf einer Seite zu öffnen, setzen Sie is_source und dann ii_page.
• 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