6. Funzioni trasversali #

← Lingua e RTL · Sommario · FAQ →

Questo capitolo raccoglie i servizi disponibili qualunque sia il componente: tooltip, hosting di controlli PowerBuilder, trascinamento dall'Esplora risorse, focus da tastiera, esportazione immagine e gli oggetti di utilità non visivi.

6.1 Tooltip semplici e avanzati #

Tooltip del componente #

uo_button.is_tooltip = "Salva la pratica (Ctrl+S)"

Il testo accetta il testo formattato con tag: [b], [br], [color=…], [picture=…]…

Tooltip avanzato (titolo + testo + immagine) #

Per una guida contestuale in stile barra multifunzione di Office:

uo_button.is_super_tooltip_title = "Salva"
uo_button.is_super_tooltip_text  = "Scrive le modifiche sul server." &
                                   + "[br][br][size-=15]Scorciatoia: Ctrl+S[/size-=15]"
uo_button.is_super_tooltip_image = "img\help_save.png"

Le tre proprietà sono indipendenti: un titolo da solo, oppure un titolo con testo senza immagine, sono validi. Non appena una proprietà is_super_tooltip_* viene impostata, questa prevale su is_tooltip.

Tooltip di un item #

Ogni classe degli item (n_pbt_item e i suoi discendenti) porta le stesse quattro proprietà:

uo_toolbar.of_item(/*keys*/ "main/save").is_tooltip = "Salva"

uo_tab.of_page(/*key*/ "clients").is_super_tooltip_title = "Clienti"
uo_tab.of_page(/*key*/ "clients").is_super_tooltip_text  = "128 schede, ultima sincronizzazione alle 09:12"

Comportamento #

• Il tooltip è una finestra nativa a tema, identica in tutti i componenti (non è limitata dai confini della webview).
• Non compare se la Sua applicazione non ha il focus: passare con il mouse sopra una finestra in secondo piano non attiva nulla.
• Scompare quando si passa a un'altra applicazione, e al più tardi dopo 10 secondi.
• of_reset() elimina i tooltip impostati sull'istanza e sui suoi item.

6.2 Ospitare veri controlli PowerBuilder #

I componenti contenitori non mostrano HTML al posto delle Sue maschere: accolgono veri controlli PowerBuilder (userobject, DataWindow, gruppi di controlli), riagganciati come finestre Win32 figlie. Le Sue maschere esistenti vengono riutilizzate così come sono.

// Schede: ogni pagina e' un userobject PB
uo_tab.of_add_page(/*key*/ "clients",   /*title*/ "Clienti",   /*page*/ uo_page_clients)
uo_tab.of_add_page(/*key*/ "invoices",  /*title*/ "Fatture",  /*page*/ uo_page_invoices, /*closable*/ true)

// Pannelli ancorabili: allo stesso modo
uo_dock.is_main = "doc"                       // zona centrale
uo_dock.of_add_panel(/*key*/ "doc",      /*position*/ uo_dock.POSITION_STACK, /*relative_to*/ "", /*size*/ 0,   /*title*/ "Documento",    /*content*/ uo_editor)
uo_dock.of_add_panel(/*key*/ "explorer", /*position*/ uo_dock.POSITION_START, /*relative_to*/ "", /*size*/ 240, /*title*/ "Esplora risorse", /*content*/ uo_tree)
uo_dock.of_add_panel(/*key*/ "props",    /*position*/ uo_dock.POSITION_END,   /*relative_to*/ "", /*size*/ 260, /*title*/ "Proprietà",  /*content*/ uo_props)

Ciò di cui ci occupiamo al Suo posto:

• il posizionamento e il ridimensionamento del controllo ospitato quando la scheda o il pannello cambia dimensione;
• la visualizzazione / il nascondimento al cambio di scheda o di pannello attivo;
• i pannelli mobili, ancorati o nascosti automaticamente (dockcontainer);
• la distruzione pulita alla chiusura della finestra.

⚠️ Un controllo ospitato è una finestra nativa: viene disegnato al di sopra dello strato web. È voluto (la Sua DataWindow resta nitida e veloce), ma significa che nessun effetto web — ombra, trasparenza, animazione — può passare sopra di esso.

6.3 Ricevere file dall'Esplora risorse di Windows #

Un componente può diventare destinazione di rilascio per i file trascinati dall'Esplora risorse. La libreria installa una destinazione di rilascio nativa: si ricevono i percorsi completi, cosa che un rilascio HTML non consente.

uo_editor.ib_allow_drop = true

// event ue_drop_files di uo_editor: (string as_files[])
long ll_i

for ll_i = 1 to UpperBound(as_files)
    of_open_file(as_files[ll_i])
next

Il componente fornisce da sé il riscontro visivo del passaggio del mouse (evidenziazione della zona di rilascio). Pubblicato dai componenti in cui il rilascio ha senso: statictext, codeeditor.

6.4 Tastiera e focus #

Un componente PBToolboxAI partecipa alla navigazione da tastiera della Sua finestra come un controllo nativo:

• il tasto Tab lo raggiunge nell'ordine di tabulazione della finestra;
• i tasti (frecce, Invio, Esc, immissione) sono gestiti dal componente che ha il focus;
• le scorciatoie di finestra (Invio = pulsante predefinito, Esc = annulla) continuano a funzionare anche quando il focus è dentro un componente.

Per dare esplicitamente il focus al contenuto di un componente (per esempio dopo aver aperto un pannello di ricerca):

uo_editor.of_focus_webview()

6.5 Esportare il rendering come immagine #

Un promemoria dalla base comune: ogni componente si esporta così come è visualizzato.

uo_tiles.of_save_as_png(/*path*/ "C:\temp\accueil.png")
uo_tiles.of_save_as_jpg(/*path*/ "C:\temp\accueil.jpg")

Utile per allegare una schermata a un'e-mail, alimentare un report o documentare un incidente utente.

6.6 Finestre di dialogo e notifiche #

Due servizi senza alcun controllo da posizionare nella finestra:

// Finestra di dialogo modale a tema (ritorno sincrono)
n_pbt_messagebox lnv_mb

lnv_mb = create n_pbt_messagebox
lnv_mb.is_title   = "Eliminazione"
lnv_mb.is_message = "Eliminare definitivamente [b]12 pratiche[/b]?"
lnv_mb.is_icon    = lnv_mb.ICON_QUESTION
lnv_mb.of_add_button(/*text*/ "Elimina", /*default*/ false, /*cancel*/ false)
lnv_mb.of_add_button(/*text*/ "Annulla",   /*default*/ true,  /*cancel*/ true)

if lnv_mb.of_show(/*hwnd*/ Handle(this)) = 1 then of_delete()
destroy lnv_mb

// Notifica "toast" in un angolo dello schermo, non bloccante
n_pbt_toaster lnv_toast

lnv_toast = create n_pbt_toaster
lnv_toast.is_title = "Importazione completata"
lnv_toast.is_text  = "1 240 righe integrate."
lnv_toast.is_kind  = lnv_toast.KIND_SUCCESS
lnv_toast.of_show()
destroy lnv_toast

Dettagli completi: messagebox e toaster.

6.7 Oggetti di utilità non visivi #

Forniti nella stessa PBL, senza webview né rendering: sono semplici involucri attorno alla DLL. Li crei, li usi, li distrugga.

Base64, hash, identificatori — n_pbt_crypto #

Base64 (testo o file), hash SHA e identificatori unici vivono nel componente crypto: of_base64_encode, of_base64_encode_file, of_sha256, of_hash_file, of_uuid… Una sola pagina per tutto ciò che calcola senza mostrare nulla.

Espressioni regolari — u_pbt_regex #

Sintassi ECMAScript, assente da PowerScript.

Senza una chiave che lo copra, u_pbt_regex funziona in modalità demo: il testo analizzato è al massimo di 2048 caratteri; oltre, la chiamata fallisce e is_last_error lo indica. Perché la chiave della vostra applicazione si applichi, impostate ipo_owner sull'oggetto che lo usa (lnv_re.ipo_owner = this), come per crypto.

u_pbt_regex lnv_re
string ls_found[]

lnv_re = create u_pbt_regex

if lnv_re.of_is_match(/*pattern*/ "^[\w.]+@[\w.]+\.\w{2,}$", /*input*/ ls_email) then …

ls_year = lnv_re.of_match(/*pattern*/ "(\d{4})-(\d{2})-(\d{2})", /*input*/ ls_date, /*group*/ 1)
ls_clean = lnv_re.of_replace(/*pattern*/ "\s+", /*input*/ ls_input, /*replacement*/ " ")
ll_nb = lnv_re.of_match_all(/*pattern*/ "[A-Z]{2}\d{6}", /*input*/ ls_text, /*matches*/ ls_found)

destroy lnv_re

Opzioni combinabili: FLAG_IGNORE_CASE (1), FLAG_SINGLELINE (2, il . attraversa le interruzioni di riga).

Archivi ZIP — u_pbt_zip #

u_pbt_zip lnv_zip

lnv_zip = create u_pbt_zip
lnv_zip.of_compress(/*zip*/ "C:\temp\livraison.zip", /*src*/ "C:\appli\export")   // file OPPURE cartella
lnv_zip.of_extract(/*zip*/ "C:\temp\livraison.zip",  /*dest*/ "C:\appli\import")   // cartella creata se assente
destroy lnv_zip

I due metodi restituiscono un boolean.

Senza una chiave che lo copra, u_pbt_zip funziona in modalità demo: ciò che comprime (un file o una cartella, in totale) e l'archivio che estrae sono al massimo di 2048 byte; oltre, il metodo restituisce false e is_last_error lo indica. Impostate ipo_owner sull'oggetto che lo usa (lnv_zip.ipo_owner = this) perché la chiave della vostra applicazione si applichi.

6.8 Informazioni sulla libreria #

// Versione della DLL: un long, maggiore x 10000 + minore x 100 + correzione
long ll_version

ll_version = PBT_GetVersion()   // 40000 = 4.00.00

6.9 Stampare #

Ogni componente sa stamparsi, così com'è visualizzato, senza DataWindow intermedia.

// Silenzioso: un PDF su disco, nulla da cliccare
uo_grid.of_print_to_pdf(/*path*/ "C:\etats\ventes.pdf")

// Orizzontale, per una griglia larga
uo_grid.of_print_to_pdf(/*path*/ "C:\etats\ventes.pdf", /*landscape*/ true)

// Con finestra di dialogo: l'utente sceglie la stampante e vede l'anteprima
uo_grid.of_print()

// Direttamente la finestra di stampa di sistema
uo_grid.of_print(/*system_dialog*/ /*dialogue systeme*/ true)

⚠️ Si stampa ciò che è RESO. Una griglia virtualizzata stampa solo le righe che detiene: per un rapporto completo, passi prima a una disposizione che le mostri tutte (paginazione), oppure esporti i dati anziché il rendering.

Il codice di ritorno -6 segnala un runtime WebView2 troppo vecchio per stampare (1.0.1108 per il PDF, 1.0.1587 per la finestra). Tutto il resto segue i codici di ritorno comuni.

← Lingua e RTL · Sommario · FAQ →