11. Note di versione #

← Migrare dalla 2.0 alla 3.0 · Sommario

Una versione acquistata non perde mai i suoi componenti: la 3.0 contiene i ventuno della 1.0 e della 2.0, e una chiave la cui manutenzione copre la data della Sua build compila con la DLL più recente — vedere Licenza.

3.0 — settembre 2026 #

Undici componenti: dati, utilità e media #

• Breadcrumb — il percorso di navigazione: dove ci si trova, e ritorno a qualsiasi livello con un clic. Rami aperti su richiesta, inserimento diretto del percorso, file rilasciati su un segmento.
• Button bar — una fila di pulsanti di comando — icona, etichetta o entrambe — in un solo componente; un clic restituisce la chiave del pulsante.
• Crosstab — la tabella pivot dinamica di un DataStore: righe, colonne, valori aggregati, filtri, subtotali, campi e misure calcolati, esportazione CSV ed Excel.
• Crypto — impronte, HMAC, cifratura con password o con chiave, firme RSA, ECDSA ed Ed25519, JWT, password con sale, TOTP a due fattori e DPAPI — senza installare nulla.
• JSON — costruire un documento JSON tipo per tipo, leggerlo lungo un percorso e modificarlo sul posto, in PowerScript puro.
• JSON tree — un documento JSON mostrato come in un editor di codice: numeri di riga, colorazione per tipo, ogni blocco comprimibile, ricerca.
• REST client — un client HTTPS nativo e asincrono: GET, POST, intestazioni, JSON, multipart, cookie, nuovi tentativi, download di file — senza il muro CORS di un browser.
• Speech out — la lettura ad alta voce con le voci installate sulla postazione: frase e parola in corso, coda, dizionario di pronuncia, lettura sincrona.
• Video player — un lettore video con la propria barra a tema: sottotitoli, schermo intero, capitoli, marcatori, playlist, cattura del fotogramma.
• XML — costruire un documento XML elemento per elemento e leggerlo con un vero XPath: spazi dei nomi, modifica, trasformazione XSLT.
• XML tree — un documento XML mostrato come in un editor di codice: tag, attributi e testo colorati, ogni elemento comprimibile, ricerca.

Cosa cambia #

• Ogni posizione passata a un metodo conta da 1, come quelle che gli eventi di riordino restituiscono già; una voce a cascata restituisce il suo indirizzo completo. I dettagli, e cosa modificare: Migrare dalla 2.0 alla 3.0.
• Button resta fornito e supportato, ma è deprecato a favore di Button bar: una fila di pulsanti sta in un solo componente.

Altrove nella libreria #

• of_set_property, of_get_property e of_component_name: pilotare una proprietà dal suo nome, per una schermata di impostazioni o una configurazione salvata.
• La finestra di messaggio propone un elenco di scelte (of_add_choice, of_choose) oltre ai suoi pulsanti.

Corretto #

• Un colore riletto (il_text_color, il_accent…) restituiva 0, nero, che fosse impostato o no: restituisce il colore impostato, e -1 quando è quello del tema.
• ue_error di Picture e Shell explorer non veniva mai sollevato.
• Testo formattato: una [parola] sconosciuta faceva sparire il resto del testo; ora viene mostrata così com'è.
• Barra di stato: ue_panel_rclicked fornisce coordinate schermo, da passare così come sono a un menu contestuale.

2.0 — settembre 2026 #

Cinque componenti, tutti dedicati alla navigazione #

• Menu bar — barra dei menu dell'applicazione: menu, sottomenu, voci spuntabili, separatori, icone, scorciatoie e mnemonici &File, disegnata dalla libreria nel tema dell'applicazione.
• Command palette — una scorciatoia, tre lettere, e qualsiasi azione dell'applicazione è raggiunta senza cercarla nei menu. Ricerca su etichetta, gruppo e parole chiave, più parole alla volta.
• Radial menu — i comandi in corona attorno al cursore al clic destro, scelti per direzione anziché scorrendo un elenco.
• Shell explorer — l'albero del vero shell di Windows: Desktop, Questo PC, unità, cartelle, Rete, con le icone del computer. Un solo of_expand apre un percorso profondo.
• Stepbar — il filo dei passaggi di una procedura guidata: quelli compiuti, quello in corso e quelli a venire, in orizzontale o in verticale.

Un'API rimodellata sui sedici della 1.0 #

Una chiave, un indirizzo; tutto dal componente; un'aggiunta restituisce un codice. Le tre regole, il prima/dopo e ogni firma cambiata sono in Migrare dalla 1.0 alla 2.0. Il motivo: un handle che aggiungeva non poteva dire di aver rifiutato, e tre argomenti per designare un item obbligavano ogni componente a inventare il proprio modo di farlo.

Su tutti i componenti #

• of_count, of_keys_at e of_has, sul componente e a ogni livello: ciò che un componente contiene si chiede, non c'è più bisogno di tenerne conto da soli.
• Ogni metodo che restituisce un long dice cosa significa il suo ritorno: 0 applicato, -5 argomento non valido, -2 componente non creato — nella doc incorporata della demo come qui.
• Le proprietà di un item si rileggono dal vivo: l'icona di una voce della listbar, il testo e l'icona di una piastrella, lo stato di un pulsante di barra — un getter dice ciò che è a schermo, mai un valore memorizzato.
• ib_visible su ogni voce di menu — barra dei menu, menu contestuale, menu radiale, menu della barra multifunzione: nascondere non è disattivare, la voce lascia il menu, scorciatoia compresa, e conserva la chiave per tornare.
• La barra di stato costruisce i suoi menu una voce alla volta (of_add_menu_item ("panel/id", …)), con un handle di voce che disattiva, spunta e nasconde — al posto dei due array paralleli di of_set_panel_menu.
• ue_script_error: un errore di script nella pagina arriva a PowerBuilder con messaggio e stack, invece di perdersi.

Corretto #

• Un item disattivato o nascosto non risponde più a nulla: né clic né tastiera — la listbar selezionava ancora una voce disattivata con Invio.
• Il testo disattivato si legge in tutti i temi (contrasto almeno 3:1), e anche il testo al passaggio del mouse in modalità scura — due pulsanti disattivati della barra multifunzione diventavano invisibili in Office 2007.
• Un percorso Windows letto dalla pagina tornava con le barre rovesciate raddoppiate (C:\\Windows); un valore contenente virgolette veniva troncato.
• Dock container: il pannello ancorato a sinistra perdeva il bordo destro oltre il 100% di ridimensionamento dello schermo.
• Barra multifunzione: l'icona di un pulsante disattivato non era disattivata in modalità compatta; un titolo della barra dei menu si accendeva insieme a quello al passaggio del mouse.
• Editor di codice: il testo riletto dopo un ripiegamento era quello vecchio, e riespandere sovrascriveva quanto digitato.

1.0 — agosto 2026 #

Prima versione: sedici componenti — button, code editor, dock container, listbar, message box, PDF viewer, picture, progress, ribbon, statictext, statusbar, tab, tiles box, toaster, toolbar, web browser — una sola DLL da distribuire, x86 e x64 con lo stesso nome, nessuna dipendenza .NET, ActiveX o PBNI. Temi Office, Fluent e Metro, chiaro e scuro; sei lingue e RTL; licenza interamente offline; PowerBuilder da 10.2 a 2025.

← Migrare dalla 2.0 alla 3.0 · Sommario