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: nulla da installare, stampa, ricerca, moduli PDF e schermo intero 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 da codice. ii_page e ii_zoom dicono dove aprire il documento, non dove si trova l'utente. È una scelta deliberata per la 4.0; un rendering programmabile 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 ue_row_changed di dw_list : visualizzare l'allegato della riga corrente
string ls_pdf

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

// Senza allegato il visualizzatore si svuota ; altrimenti lo mostra
if ls_pdf = "" then
    uo_pdf.of_reset()          // nessun allegato : visualizzatore vuoto
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

Li imposti prima di is_source: ogni modifica ricarica il documento. 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.of_reset()
    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

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.
• Chiami of_reset() quando non deve più essere visualizzato alcun documento (cambio di riga senza allegato): altrimenti il documento precedente resta visibile.
• 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_page, ii_zoom, is_fit o ib_viewer_toolbar 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.
• 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