12. Note di versione #

← Migrare dalla 3.0 alla 4.0 · Sommario · Assistente IA →

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

4.0 — ottobre 2026 #

Cinque componenti: dati, grafici, documenti e suono #

• Cartesian chart — un grafico cartesiano animato: colonne, barre, linee, aree, dispersione, bolle, mappe di calore, candele. Il tipo si sceglie per serie: un grafico combinato (colonne e linea obiettivo su due assi) sta in un solo componente.
• Data grid — una griglia moderna posata su un DataStore: colonne tipizzate e celle ricche, ordinamento, filtri, raggruppamenti e subtotali, modifica sul posto, volumi molto grandi, esportazione CSV ed Excel. Legge ciò che il DataWindow dice di ogni colonna (titolo, formato, tabella dei codici), e il DataWindow resta il padrone dei Suoi dati.
• Markdown view — un documento Markdown in sola lettura, nei colori del tema: titoli, elenchi, tabelle, caselle di spunta, codice colorato, immagini — da un testo o da un file della postazione.
• Scheduler — un calendario in stile Outlook: viste giorno, settimana lavorativa, settimana, mese e agenda, trascinamento, risorse affiancate, categorie di colore, schede e descrizioni comandi scritte con modelli — riempito appuntamento per appuntamento o da un DataStore.
• Sound player — un oggetto non visuale che riproduce un file della postazione, un indirizzo https o un segnale acustico sintetizzato, in modo asincrono (eventi) o sincrono (la chiamata ritorna quando il suono finisce).

Cosa cambia #

• Un cambiamento chiesto dal Suo codice (of_select_*, of_expand, of_open…) solleva lo stesso evento di un gesto dell'utente, come SelectTab in PowerBuilder; le domande poste prima di un cambiamento sono facoltative e si attivano con una proprietà ib_veto_*.
• Due metodi scompaiono: of_set_data della tabella pivot diventa of_from_datastore, e of_transform di XML se ne va con XSLT, che il motore del browser sta rimuovendo. Alcuni nomi e conteggi si allineano al resto della libreria. I dettagli, e cosa modificare: Migrare dalla 3.0 alla 4.0.
• I temi seguono l'applicazione: l'accento che imposta sopravvive a un cambio di tema, e un asse di tema lasciato vuoto segue il suo.

Altrove nella libreria #

• La tastiera della finestra: Invio preme il pulsante predefinito più vicino al focus, le scorciatoie di un componente rispondono da tutta la finestra, così come una lettera sottolineata (&Salva), e F10 apre la barra dei menu.
• Tutti i menu a discesa cercano durante la digitazione e restano fluidi anche con migliaia di voci.
• Testo formattato: il tag [symbol=nome] aggiunge diciotto glifi monocromatici (orologio, luogo, persona, calendario…) che seguono il colore del testo.
• Aggiunte nella maggior parte dei componenti forniti — schede da tastiera (Ctrl+Tab, clic centrale), pannelli staccati con un doppio clic, freccia di overflow della barra dei menu, elenco a discesa nella barra degli strumenti, registro riga per riga dello statictext, dimensione reale di un'immagine, lettura di una cella della tabella pivot… L'elenco completo, componente per componente, è in Migrare dalla 3.0 alla 4.0 e nella cronologia di ogni componente.
• Un assistente IA (Claude, Cursor, VS Code…) può consultare l'API esatta della Sua versione e verificare il codice che propone, grazie al server MCP della documentazione fornito con la dimostrazione.

Corretto #

• Una proprietà decimale (double) veniva riletta con il separatore della postazione: su un Windows francese, 1.5 tornava errato.
• Il clic destro su un elemento produce ora un solo evento, in tutti i componenti.
• Tiles box: of_get_layout restituiva una disposizione vuota.

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 3.0 alla 4.0 · Sommario · Assistente IA →