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 et les formulaires PDF 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 : le lecteur ignore les paramètres d'ouverture qui surligneraient un texte ou ouvriraient son panneau latéral. Il n'a pas de commande Plein écran, et il suit le thème clair ou sombre de l'application, jamais celui du composant. 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.

Ouvrir sur un chapitre #

// Ouvert sur le chapitre "prices" du catalogue ; le bouton Sommaire du lecteur liste les signets
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, is_destination, 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