PBToolboxAI — Documentazione #

🌐 Français · English · Deutsch · Italiano · Español · Português

Libreria commerciale di componenti visivi moderni (HTML/CSS/JS renderizzati da WebView2) esposti a PowerBuilder come userobject classici. Si posiziona un controllo, si assegnano proprietà tipizzate, si ricevono event PB: nessun HTML, nessun URL, nessun JSON da manipolare.

Guida per lo sviluppatore #

#	Pagina	Contenuto
1	Installazione e distribuzione	Prerequisiti, file da distribuire, integrazione nell'IDE, runtime WebView2
2	Primi passi	Aprire e migrare la demo fornita, primo componente a schermo
3	Base comune `u_pbt_base`	Motore delle proprietà, item, event, ciclo di vita, `of_reset`
4	Temi e aspetto	Temi (stile × modalità), colore d'accento, override dei token, icone, testo formattato
5	Lingua e senso di lettura	`PBT_SetLanguage`, traduzioni, RTL
6	Funzioni trasversali	Tooltip, hosting di controlli PB, rilascio di file, focus da tastiera, esportazione immagine, utilità non visive
7	FAQ e risoluzione dei problemi	Sintomi frequenti e relative cause
8	Licenza e modalità demo	Chiavi `dev` / `runtime` / `demo`, modalità demo
9	Migrare dalla 1.0 alla 2.0	Le tre regole della 2.0, prima/dopo, ogni firma rimossa o cambiata
10	Migrare dalla 2.0 alla 3.0	Posizioni da 1, gli indirizzi delle voci a cascata, gli altri comportamenti e le aggiunte
11	Migrare dalla 3.0 alla 4.0	La domanda prima di una piastrella ora facoltativa, i codici delle aggiunte e gli handle liberati, gli altri comportamenti della barra multifunzione e le aggiunte
12	Migrare dalla 4.0 alla 5.0	La barra di avanzamento parla come gli indicatori, le maschere numeriche della griglia e della barra multifunzione, gli altri comportamenti e le aggiunte
13	Note di versione	Ciò che ogni versione porta e corregge
14	Assistente IA: il server MCP della documentazione	Il Suo assistente IA consulta l’API esatta invece di inventare chiamate, e verifica il codice che scrive

Riferimento dei componenti #

Una pagina per ogni componente della libreria: docs/composants/.

Categoria	Componenti
Vetrina	angulargauge · chartcartesian · chartpie · commandpalette · gauge · ribbon
Contenitori e navigazione	breadcrumb · contextmenu · dockcontainer · listbar · menubar · radialmenu · shellexplorer · tab · tilesbox · toolbar
Barre e avanzamento	buttonbar · progressbar · statusbar · stepbar
Testo e immissione	button · codeeditor · form · markdownview · propertygrid · statictext
Dati	crosstab · datagrid · gantt · jsontree · kanban · scheduler · treeview · xmltree
Riscontro all'utente	messagebox · toaster
Utilità non visuali	crypto · json · restclient · xml
Contenuti multimediali e visualizzatori	carousel · pdfviewer · picture · soundplayer · speechout · video · webbrowser

Che cosa si riceve #

File	Ruolo
`pbtoolboxai.dll` (x86 / x64)	Motore autonomo (bundle web, temi e dizionari incorporati)
`pbtoolboxai.pbl`	Userobject `u_pbt_`, classi degli item `n_pbt_`, dichiarazioni external functions
`pbtoolboxai_demo`	Applicazione dimostrativa (vetrina, esempi di codice, documentazione interattiva)
`docs/`	Questa documentazione
Bootstrapper WebView2 (facoltativo)	Per le rare postazioni prive del runtime

Compatibilità #

PowerBuilder: 10.2 → 2025.
Windows: 10 e 11 (runtime WebView2 preinstallato). Windows Server / LTSC: installare il runtime, vedere Installazione.
32 bit e 64 bit: entrambe le copie sono fornite con lo stesso nome, pbtoolboxai.dll (cartelle x86\ e x64\).
Nessuna dipendenza da .NET, ActiveX o PBNI e nessuna registrazione COM.

Convenzioni dell'API #

Prefissi: userobject u_pbt_, classi degli item n_pbt_, metodi of_, event ue_, export della DLL PBT_.
Ogni valore pilotabile è una proprietà, assegnata direttamente: uo_text.is_text = "Buongiorno". Le aggiunte e le azioni restano metodi (of_add_*, of_remove_*, of_reset…).
I metodi of_* restituiscono un long: ≥ 0 = OK, < 0 = errore (-2: componente non creato; -5: argomento non valido). of_get_last_error() ne fornisce il dettaglio.
I comandi emessi prima che il componente sia pronto vengono messi in coda e riprodotti automaticamente: è possibile configurare tutto già nel constructor della finestra.