pdfviewer — u_pbt_pdfviewer #

← Référence des composants · Sommaire du guide

Visionneuse PDF intégrée : affiche un document local ou publié sur le web, directement dans votre fenêtre, avec pagination, zoom et impression.

▶ Le voir en vrai — Application de démonstration, tuile PDF viewer : l'aperçu, le code qui le produit et cette page, côte à côte.

En bref #

Le composant remplace le classique « enregistrer le PDF dans un fichier temporaire puis appeler ShellExecute » : le document reste dans votre application, l'utilisateur ne quitte jamais l'écran en cours.

Démarrage rapide #

// event open de la fenetre : afficher un document present sur le disque
uo_pdf.is_source = "C:\factures\FA-2026-0142.pdf"

// event ue_load_completed de uo_pdf : (string as_source)
uo_status.of_panel(/*key*/ "main").is_text = "Document affiche"

C'est tout : poser is_source suffit à charger et afficher le document.

Propriétés #

Méthodes #

Événements #

Pourquoi un document n'est pas affiché #

as_reason de ue_load_failed est l'une de ces constantes de u_pbt_pdfviewer. Un PDF se reconnaît ainsi : un fichier local porte l'extension .pdf et commence par la signature %PDF- ; un document distant est servi avec le type application/pdf (le seul que le moteur remet à son lecteur) ; une adresse data: annonce application/pdf.

Ce que l'utilisateur peut faire, sans une ligne de code #

La visionneuse affiche sa barre d'outils intégrée au-dessus du document. Vous n'avez rien à programmer : elle est fournie et localisée par le système.

Les raccourcis du navigateur — Ctrl+F, Ctrl+P, Ctrl + molette — sont coupés dans tous les composants, celui-ci compris : passez par les boutons de la barre du lecteur.

Ce que le lecteur ne dit pas #

Le lecteur est celui qui est intégré au moteur web : aucune dépendance à installer, l'impression, la recherche, les formulaires PDF et le plein écran fournis. En contrepartie, il ne rend compte de rien à votre application : ni la page affichée, ni le nombre de pages, ni le zoom réel, ni le texte sélectionné, et la recherche ne se pilote pas par code (is_find surligne un texte à l'ouverture, rien de plus). ii_page et ii_zoom disent où ouvrir le document, pas où l'utilisateur se trouve. Un PDF protégé par un mot de passe : le lecteur le demande lui-même à l'utilisateur, votre application ne peut pas le lui fournir. Ce choix est délibéré ; un rendu scriptable demanderait une bibliothèque externe.

Exemples #

Ouvrir un document local #

// Chemin absolu, ou relatif au repertoire de l'application
uo_pdf.is_source = "doc\conditions-generales.pdf"

Ouvrir un document publié sur le web #

// Une adresse web se charge exactement comme un fichier local
uo_pdf.is_source = "https://www.monsite.fr/tarifs/catalogue-2026.pdf"

Une connexion internet est évidemment nécessaire ; le chargement est asynchrone, ue_load_completed vous signale la fin.

Afficher le PDF que vient de produire une DataWindow #

// Local variables
string ls_file

// Un fichier par jour, dans le dossier temporaire
ls_file = "C:\temp\report_" + String(Today(), "yyyymmdd") + ".pdf"

// La DataWindow produit le fichier...
dw_report.SaveAs(ls_file, PDF!, false)

// ...et la visionneuse l'affiche immediatement
uo_pdf.is_source = ls_file

Rafraîchir après régénération du fichier #

// Le fichier a ete reecrit au meme emplacement : recharger sans retoucher is_source
uo_pdf.of_refresh()

Enchaîner plusieurs documents dans la même visionneuse #

// event rowfocuschanged de dw_list : (long currentrow)
// Local variables
string ls_pdf

// Le chemin du PDF de la ligne courante
ls_pdf = dw_list.GetItemString(currentrow, "pdf_path")

// Sans piece, la visionneuse se vide (ses reglages gardes) ; sinon elle l'affiche
if ls_pdf = "" then
	uo_pdf.is_source = ""
else
	uo_pdf.is_source = ls_pdf
end if

Suivre la fin du chargement #

// event ue_load_completed de uo_pdf : (string as_source)
uo_wait.Hide()

// of_print imprime le document affiche
uo_print_button.ib_enabled = true

Dire pourquoi le document n'est pas là #

// event ue_load_failed de 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 = "Document introuvable : " + as_source
	case uo_pdf.REASON_NOT_PDF
		uo_status.of_panel(/*key*/ "main").is_text = "Ce fichier n'est pas un PDF"
	case else
		uo_status.of_panel(/*key*/ "main").is_text = "Document indisponible (" + as_reason + ")"
end choose

Ouvrir ailleurs un lien du document #

// event ue_link_clicked de uo_pdf : (string as_url)
// La visionneuse reste sur le document : le lien s'ouvre dans le navigateur de la fenetre
uo_web.is_address = as_url

Imprimer le document #

// clicked du bouton Imprimer : l'apercu du lecteur PDF, sur le document lui-meme
if uo_pdf.of_print() = -4 then
	uo_status.of_panel(/*key*/ "main").is_text = "Aucun document a imprimer"
end if

Montrer sans laisser enregistrer ni imprimer #

// Un document confidentiel : ni Enregistrer ni Imprimer dans la barre du lecteur
uo_pdf.ib_allow_save = false
uo_pdf.ib_allow_print = false
uo_pdf.is_source = is_current_document

Posez-les avant is_source : le document ne se charge qu'une fois. Chaque visionneuse garde son réglage. Ce n'est pas une protection : le fichier reste lisible sur le disque, et of_print imprime toujours.

Aperçu dans un onglet, à côté de la saisie #

// event open : la visionneuse occupe une page d'onglet, la saisie l'autre
uo_tab.of_add_page(/*key*/ "entry",  /*title*/ "Saisie",   /*page*/ uo_page_entry)
uo_tab.of_add_page(/*key*/ "preview",  /*title*/ "Apercu",   /*page*/ uo_page_preview)

// La visionneuse est posee dans uo_page_preview comme n'importe quel controle
uo_pdf.is_source = is_current_document

Le composant s'héberge sans précaution particulière dans un tab ou un panneau dockcontainer.

Vérifier le fichier avant de l'afficher #

// Local variables
string ls_path

// Le fichier de la facture affichee
ls_path = "C:\factures\" + is_number + ".pdf"

// Pas de fichier, rien a montrer : on vide la visionneuse plutot que de laisser l'ancien document
if not FileExists(ls_path) then
    uo_pdf.is_source = ""
    uo_status.of_panel(/*key*/ "main").is_text = "Facture introuvable"
    return
end if

// Sinon, la facture s'affiche
uo_pdf.is_source = ls_path

Afficher un PDF lu en base (blob) #

// Local variables
blob lblb_pdf

// La facture rangee en base, lue dans un blob
SELECTBLOB pdf_file INTO :lblb_pdf FROM invoice WHERE invoice_no = :is_number USING SQLCA;

// Affichee directement depuis la memoire : aucun fichier temporaire, quelle que soit sa taille
if SQLCA.SQLCode = 0 then
	uo_pdf.of_load_blob(/*pdf*/ lblb_pdf, /*name*/ "invoice-" + is_number + ".pdf")
end if

Le nom donné revient dans is_source et dans ue_load_completed ; le blob est libéré par le document suivant ou par of_reset.

Montrer une ligne précise du document #

// Le lecteur s'ouvre sur le premier passage de ce texte, surligne
uo_pdf.is_find = "Delivery and assembly"
uo_pdf.is_source = "C:\factures\FA-2026-0142.pdf"

Ouvrir sur un chapitre, signets visibles #

// Le panneau lateral et ses signets, ouvert sur le chapitre "prices" du catalogue
uo_pdf.ib_navigation_pane = true
uo_pdf.is_destination = "prices"
uo_pdf.is_source = "doc\catalogue-2026.pdf"

Le nom d'une destination est celui que l'outil qui a produit le PDF a écrit : votre générateur de documents le connaît.

Un document derrière un jeton, ou servi en octet-stream #

// Local variables
long ll_status
string ls_file

// Le restclient (inv_rest, prepare a l'ouverture de la fenetre) envoie le jeton et telecharge le fichier
ls_file = "C:\temp\invoice-4152.pdf"
ll_status = inv_rest.of_download(/*url*/ "/orders/4152/invoice.pdf", /*path*/ ls_file)

// Puis la visionneuse affiche le fichier, quel que soit le type annonce par le serveur
if ll_status = 200 then
	uo_pdf.is_source = ls_file
end if

Le lecteur du moteur ne sait ni envoyer un jeton ni afficher une réponse application/octet-stream (REASON_AUTH, REASON_NOT_PDF) : le restclient le fait pour lui.

Formats et chemins acceptés #

Seul le PDF est pris en charge par ce composant : ce qui n'en est pas un est refusé et signalé par ue_load_failed (REASON_NOT_PDF). Pour une image, utilisez picture ; pour une page HTML, webbrowser.

Bonnes pratiques #

• Surveillez ue_load_failed : un chemin invalide, un fichier qui n'est pas un PDF ou un site injoignable y est signalé avec sa raison, et la visionneuse reste vide.
• Pour vider la visionneuse (changement de ligne sans pièce jointe), posez is_source = "" : sinon le document précédent reste visible. of_reset() la vide aussi, mais remet en plus tous les réglages à leur défaut — Enregistrer et Imprimer compris.
• of_refresh() est le moyen d'afficher un fichier régénéré au même chemin : il relit le fichier sans toucher aux réglages. Il ne garde pas la position de défilement — le lecteur repart à ii_page.
• Chaque changement de ii_zoom, is_fit, ib_viewer_toolbar, ib_navigation_pane, is_destination, is_find, ib_allow_save ou ib_allow_print recharge le document (le lecteur ne lit ses réglages qu'au chargement) et relève ue_load_completed : posez-les avant is_source pour un seul chargement. La même valeur reposée ne recharge rien. ii_page posé pendant qu'un document est affiché vaut pour ce document : pour en ouvrir un autre sur une page, posez is_source puis ii_page.
• Prévoyez un indicateur d'attente pour les documents distants ou volumineux, et masquez-le sur ue_load_completed et sur ue_load_failed.
• Donnez au composant une surface confortable (au moins la moitié de la fenêtre) : la barre d'outils intégrée et le document ont besoin de place pour rester lisibles.
• Pour afficher une page web plutôt qu'un PDF, utilisez webbrowser ; pour une image, picture.

Hérité du socle commun #

Ces membres existent sur tous les composants visuels — ils ne sont pas propres à celui-ci. Ils sont détaillés une seule fois, dans les chapitres transverses ; cette table dit seulement où les lire.

Deux aides ne sont pas héritées : of_icon et of_escape_markup vivent sur n_pbt_utils. Déclarez-en une — n_pbt_utils lnv_utils, rien à créer — et appelez-les dessus.

← Référence des composants · Sommaire du guide