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. ii_page et ii_zoom disent où ouvrir le document, pas où l'utilisateur se trouve. Ce choix est délibéré pour la 4.0 ; 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 ue_row_changed de dw_list : afficher la piece jointe de la ligne courante
string ls_pdf

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

// Sans piece, la visionneuse se vide ; sinon elle l'affiche
if ls_pdf = "" then
    uo_pdf.of_reset()          // aucune piece : visionneuse vide
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 : chaque changement recharge le document. 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.of_reset()
    uo_status.of_panel(/*key*/ "main").is_text = "Facture introuvable"
    return
end if

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

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.
• Appelez of_reset() quand plus aucun document ne doit être affiché (changement de ligne sans pièce jointe) : sinon le document précédent reste visible.
• 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_page, ii_zoom, is_fit ou ib_viewer_toolbar 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.
• 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