pdfviewer — u_pbt_pdfviewer #

← Riferimento dei componenti · Sommario della guida

Visualizzatore PDF integrato: mostra un documento locale o pubblicato sul web, direttamente nella Sua finestra, con paginazione, zoom e stampa.

▶ Vederlo dal vivo — Applicazione dimostrativa, riquadro PDF viewer: l'anteprima, il codice che lo produce e questa pagina, affiancati.

In breve #

Il componente sostituisce il classico « salvare il PDF in un file temporaneo e poi chiamare ShellExecute »: il documento resta all'interno della Sua applicazione, l'utente non lascia mai la schermata corrente.

Avvio rapido #

// event open della finestra : visualizzare un documento presente su disco
uo_pdf.is_source = "C:\factures\FA-2026-0142.pdf"

// event ue_load_completed di uo_pdf : (string as_source)
uo_status.of_panel(/*key*/ "main").is_text = "Documento visualizzato"

Tutto qui: impostare is_source è sufficiente per caricare e visualizzare il documento.

Proprietà #

Metodi #

Event #

Perché un documento non viene visualizzato #

as_reason di ue_load_failed è una di queste costanti di u_pbt_pdfviewer. Un PDF si riconosce così: un file locale ha l'estensione .pdf e inizia con la firma %PDF-; un documento remoto è servito con il tipo application/pdf (l'unico che il motore consegna al suo lettore); un indirizzo data: dichiara application/pdf.

Che cosa può fare l'utente, senza una riga di codice #

Il visualizzatore mostra la sua barra degli strumenti integrata sopra il documento. Non c'è nulla da programmare: viene fornita e localizzata dal sistema.

Le scorciatoie del browser — Ctrl+F, Ctrl+P, Ctrl + rotellina — sono disattivate in tutti i componenti, compreso questo: usi i pulsanti della barra del lettore.

Ciò che il lettore non dice #

Il lettore è quello integrato nel motore web: niente da installare, stampa, ricerca e moduli PDF inclusi. In cambio, non comunica nulla alla Sua applicazione: né la pagina visualizzata, né il numero di pagine, né lo zoom reale, né il testo selezionato, e la ricerca non si pilota dal codice: il lettore ignora i parametri di apertura che evidenzierebbero un testo o aprirebbero il suo pannello laterale. Non ha un comando Schermo intero e segue il tema chiaro o scuro dell'applicazione, mai quello del componente. ii_page e ii_zoom dicono dove aprire il documento, non dove si trova l'utente. Un PDF protetto da password: il lettore la chiede da sé all'utente, la Sua applicazione non può fornirla. È una scelta deliberata; un rendering pilotabile da script richiederebbe una libreria esterna.

Esempi #

Aprire un documento locale #

// Percorso assoluto, oppure relativo alla directory dell'applicazione
uo_pdf.is_source = "doc\conditions-generales.pdf"

Aprire un documento pubblicato sul web #

// Un indirizzo web si carica esattamente come un file locale
uo_pdf.is_source = "https://www.monsite.fr/tarifs/catalogue-2026.pdf"

Ovviamente è necessaria una connessione a internet; il caricamento è asincrono, ue_load_completed Le segnala la fine.

Visualizzare il PDF appena prodotto da una DataWindow #

// Local variables
string ls_file

// Un file al giorno, nella cartella temporanea
ls_file = "C:\temp\report_" + String(Today(), "yyyymmdd") + ".pdf"

// La DataWindow produce il file...
dw_report.SaveAs(ls_file, PDF!, false)

// ...e il visualizzatore lo mostra immediatamente
uo_pdf.is_source = ls_file

Aggiornare dopo la rigenerazione del file #

// Il file e stato riscritto nella stessa posizione : ricaricare senza toccare is_source
uo_pdf.of_refresh()

Concatenare più documenti nello stesso visualizzatore #

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

// Il percorso del PDF della riga corrente
ls_pdf = dw_list.GetItemString(currentrow, "pdf_path")

// Senza allegato il visualizzatore si svuota (impostazioni mantenute) ; altrimenti lo mostra
if ls_pdf = "" then
	uo_pdf.is_source = ""
else
	uo_pdf.is_source = ls_pdf
end if

Seguire la fine del caricamento #

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

// of_print stampa il documento visualizzato
uo_print_button.ib_enabled = true

Dire perché il documento non c'è #

// event ue_load_failed di 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 = "Documento non trovato: " + as_source
	case uo_pdf.REASON_NOT_PDF
		uo_status.of_panel(/*key*/ "main").is_text = "Questo file non e un PDF"
	case else
		uo_status.of_panel(/*key*/ "main").is_text = "Documento non disponibile (" + as_reason + ")"
end choose

Aprire altrove un link del documento #

// event ue_link_clicked di uo_pdf : (string as_url)
// Il visualizzatore resta sul documento : il link si apre nel browser della finestra
uo_web.is_address = as_url

Stampare il documento #

// clicked del pulsante Stampa : l'anteprima del lettore PDF, sul documento stesso
if uo_pdf.of_print() = -4 then
	uo_status.of_panel(/*key*/ "main").is_text = "Nessun documento da stampare"
end if

Mostrare senza lasciar salvare né stampare #

// Un documento riservato : ne Salva ne Stampa nella barra del lettore
uo_pdf.ib_allow_save = false
uo_pdf.ib_allow_print = false
uo_pdf.is_source = is_current_document

Le imposti prima di is_source: il documento si carica una sola volta. Ogni visualizzatore mantiene la propria impostazione. Non è una protezione: il file resta leggibile sul disco, e of_print stampa comunque.

Anteprima in una scheda, accanto all'inserimento dati #

// event open : il visualizzatore occupa una pagina della scheda, l'inserimento dati l'altra
uo_tab.of_add_page(/*key*/ "entry",  /*title*/ "Inserimento",   /*page*/ uo_page_entry)
uo_tab.of_add_page(/*key*/ "preview",  /*title*/ "Anteprima",   /*page*/ uo_page_preview)

// Il visualizzatore e collocato in uo_page_preview come qualsiasi altro controllo
uo_pdf.is_source = is_current_document

Il componente si ospita senza particolari precauzioni in un tab o in un pannello dockcontainer.

Verificare il file prima di visualizzarlo #

// Local variables
string ls_path

// Il file della fattura visualizzata
ls_path = "C:\factures\" + is_number + ".pdf"

// Nessun file, niente da mostrare : si svuota il visualizzatore invece di lasciare il documento precedente
if not FileExists(ls_path) then
    uo_pdf.is_source = ""
    uo_status.of_panel(/*key*/ "main").is_text = "Fattura non trovata"
    return
end if

// Altrimenti, la fattura viene mostrata
uo_pdf.is_source = ls_path

Visualizzare un PDF letto dal database (blob) #

// Local variables
blob lblb_pdf

// La fattura salvata nel database, letta in un blob
SELECTBLOB pdf_file INTO :lblb_pdf FROM invoice WHERE invoice_no = :is_number USING SQLCA;

// Mostrata direttamente dalla memoria : nessun file temporaneo, qualunque sia la dimensione
if SQLCA.SQLCode = 0 then
	uo_pdf.of_load_blob(/*pdf*/ lblb_pdf, /*name*/ "invoice-" + is_number + ".pdf")
end if

Il nome dato ritorna in is_source e in ue_load_completed; il blob viene liberato dal documento successivo o da of_reset.

Aprire su un capitolo #

// Aperto sul capitolo "prices" del catalogo; il pulsante Sommario del lettore elenca i segnalibri
uo_pdf.is_destination = "prices"
uo_pdf.is_source = "doc\catalogue-2026.pdf"

Il nome di una destinazione è quello scritto dallo strumento che ha prodotto il PDF: il Suo generatore di documenti lo conosce.

Un documento dietro un token, o servito come octet-stream #

// Local variables
long ll_status
string ls_file

// Il restclient (inv_rest, preparato all'apertura della finestra) invia il token e scarica il file
ls_file = "C:\temp\invoice-4152.pdf"
ll_status = inv_rest.of_download(/*url*/ "/orders/4152/invoice.pdf", /*path*/ ls_file)

// Poi il visualizzatore mostra il file, qualunque tipo abbia annunciato il server
if ll_status = 200 then
	uo_pdf.is_source = ls_file
end if

Il lettore del motore non sa né inviare un token né mostrare una risposta application/octet-stream (REASON_AUTH, REASON_NOT_PDF): il restclient lo fa al suo posto.

Formati e percorsi accettati #

Questo componente supporta soltanto il PDF: tutto il resto viene rifiutato e segnalato da ue_load_failed (REASON_NOT_PDF). Per un'immagine, usi picture; per una pagina HTML, webbrowser.

Buone pratiche #

• Tenga d'occhio ue_load_failed: un percorso non valido, un file che non è un PDF o un sito irraggiungibile vi viene segnalato con la sua causa, e il visualizzatore resta vuoto.
• Per svuotare il visualizzatore (cambio di riga senza allegato), imposti is_source = "": altrimenti il documento precedente resta visibile. Anche of_reset() lo svuota, ma riporta inoltre tutte le impostazioni al loro valore predefinito — Salva e Stampa compresi.
• of_refresh() è il modo per mostrare un file rigenerato allo stesso percorso: rilegge il file senza toccare le impostazioni. Non conserva la posizione di scorrimento — il lettore riparte da ii_page.
• Ogni modifica di ii_zoom, is_fit, ib_viewer_toolbar, is_destination, ib_allow_save o ib_allow_print ricarica il documento (il lettore legge le impostazioni solo al caricamento) e attiva di nuovo ue_load_completed: le imposti prima di is_source per un solo caricamento. Lo stesso valore reimpostato non ricarica nulla. ii_page impostato mentre un documento è visualizzato vale per quel documento: per aprirne un altro su una pagina, imposti is_source e poi ii_page.
• Preveda un indicatore di attesa per i documenti remoti o voluminosi, e lo nasconda su ue_load_completed e su ue_load_failed.
• Dia al componente una superficie confortevole (almeno metà della finestra): la barra degli strumenti integrata e il documento hanno bisogno di spazio per restare leggibili.
• Per visualizzare una pagina web anziché un PDF, usi webbrowser; per un'immagine, picture.

Ereditato dalla base comune #

Questi membri esistono su tutti i componenti visivi — non sono propri di questo. Sono descritti una sola volta, nei capitoli trasversali; questa tabella dice solo dove leggerli.

Due aiuti non sono ereditati: of_icon e of_escape_markup vivono su n_pbt_utils. Ne dichiari uno — n_pbt_utils lnv_utils, niente da creare — e li chiami su di esso.

← Riferimento dei componenti · Sommario della guida