pdfviewer — u_pbt_pdfviewer #

← Referência dos componentes · Índice do guia

Visualizador de PDF integrado: apresenta um documento local ou publicado na web, diretamente na janela da aplicação, com paginação, zoom e impressão.

▶ Ver ao vivo — Aplicação de demonstração, mosaico PDF viewer: a pré-visualização, o código que o produz e esta página, lado a lado.

Em resumo #

O componente substitui o clássico «gravar o PDF num ficheiro temporário e depois chamar ShellExecute»: o documento permanece dentro da aplicação e o utilizador nunca sai do ecrã em curso.

Início rápido #

// event open da janela : apresentar um documento presente no disco
uo_pdf.is_source = "C:\factures\FA-2026-0142.pdf"

// event ue_load_completed de uo_pdf : (string as_source)
uo_statut.of_item("main").is_text = "Documento apresentado"

É tudo: basta definir is_source para carregar e apresentar o documento.

Propriedades #

Métodos #

Eventos #

O que o utilizador pode fazer, sem uma linha de código #

O visualizador apresenta a sua barra de ferramentas integrada por cima do documento. Não é necessário programar nada: ela é fornecida e localizada pelo sistema.

Exemplos #

Abrir um documento local #

// Caminho absoluto, ou relativo ao diretorio da aplicacao
uo_pdf.is_source = "doc\conditions-generales.pdf"

Abrir um documento publicado na web #

// Um endereco web carrega-se exatamente como um ficheiro local
uo_pdf.is_source = "https://www.monsite.fr/tarifs/catalogue-2026.pdf"

É evidentemente necessária uma ligação à internet; o carregamento é assíncrono e ue_load_completed assinala o fim.

Apresentar o PDF acabado de produzir por uma DataWindow #

string ls_fichier

ls_fichier = "C:\temp\etat_" + String(Today(), "yyyymmdd") + ".pdf"

// A DataWindow produz o ficheiro...
dw_etat.SaveAs(ls_fichier, PDF!, false)

// ...e o visualizador apresenta-o imediatamente
uo_pdf.is_source = ls_fichier

Atualizar após a regeneração do ficheiro #

// O ficheiro foi reescrito no mesmo local : recarregar sem alterar is_source
uo_pdf.of_refresh()

Encadear vários documentos no mesmo visualizador #

// event ue_row_changed de dw_liste : apresentar o anexo da linha atual
string ls_pdf

ls_pdf = dw_liste.GetItemString(dw_liste.GetRow(), "chemin_pdf")

if ls_pdf = "" then
    uo_pdf.of_reset()          // nenhum anexo : visualizador vazio
else
    uo_pdf.is_source = ls_pdf
end if

Acompanhar o fim do carregamento #

// event ue_load_completed de uo_pdf : (string as_source)
uo_attente.Hide()
uo_imprimer.ib_enabled = true

Pré-visualização num separador, ao lado da introdução de dados #

// event open : o visualizador ocupa uma pagina de separador, a introducao de dados a outra
uo_tab.of_add_page("saisie",  "Introducao", uo_page_saisie)
uo_tab.of_add_page("apercu",  "Previsao",   uo_page_apercu)

// O visualizador esta colocado em uo_page_apercu como qualquer outro controlo
uo_pdf.is_source = is_document_courant

O componente aloja-se sem qualquer precaução especial num tab ou num painel dockcontainer.

Verificar o ficheiro antes de o apresentar #

string ls_chemin

ls_chemin = "C:\factures\" + is_numero + ".pdf"

if not FileExists(ls_chemin) then
    // Nada a mostrar : esvazia-se o visualizador em vez de deixar o documento anterior
    uo_pdf.of_reset()
    uo_statut.of_item("main").is_text = "Fatura nao encontrada"
    return
end if

uo_pdf.is_source = ls_chemin

Formatos e caminhos aceites #

Apenas o PDF é suportado por este componente: para uma imagem, deve utilizar-se picture; para uma página HTML, webbrowser.

Boas práticas #

• Verificar a existência do ficheiro antes de atribuir is_source: um caminho inválido deixa simplesmente o visualizador vazio, sem erro bloqueante.
• Chamar of_reset() quando já nenhum documento deve ser apresentado (mudança de linha sem anexo): caso contrário, o documento anterior permanece visível.
• Preferir of_refresh() a uma reatribuição de is_source para recarregar o mesmo documento: é mais rápido e a posição de leitura é reposta corretamente.
• Prever um indicador de espera para os documentos remotos ou volumosos, e ocultá-lo em ue_load_completed.
• Atribuir ao componente uma superfície confortável (pelo menos metade da janela): a barra de ferramentas integrada e o documento precisam de espaço para permanecerem legíveis.
• Para apresentar uma página web em vez de um PDF, deve utilizar-se webbrowser; para uma imagem, picture.

← Referência dos componentes · Índice do guia