Documentation
Nessuna procedura guidata, nessuna registrazione COM, nessun diritto di amministratore: due file da copiare e poi inserite il componente come un qualsiasi controllo PowerBuilder.
Copiate pbtoolboxai.pbl nella cartella della vostra applicazione e aggiungetela alla library list del target. Le dichiarazioni external function sono già nell'antenato: nulla da ridichiarare.
Un solo file autonomo, pbtoolboxai.dll: i bundle web, i temi e i dizionari sono incorporati al suo interno. La copia x86 va accanto a pbXXX.exe per l'IDE, quella x64 accanto a un eseguibile a 64 bit.
Insert → Control → User Object, scegliete u_pbt_statictext, dategli un nome e una dimensione. Nel painter mostra una cornice grigia: il rendering vero avviene in esecuzione.
Assegnate le proprietà, scrivete gli event. I comandi emessi prima che il componente sia pronto vengono messi in coda e riprodotti: non c'è alcun ordine di inizializzazione da rispettare.
// Window constructor -- the component is not created yet : these commands
// are queued and replayed as soon as it is ready.
uo_text.is_theme_style = uo_text.THEME_STYLE_FLUENT
uo_text.is_theme_mode = uo_text.THEME_MODE_DARK
uo_text.is_text = "Welcome to [b]PBToolboxAI[/b] !"
uo_text.is_align = uo_text.ALIGN_CENTER
uo_text.il_text_color = RGB(0, 103, 192)
// ue_clicked event of u_pbt_statictext
Open(w_detail)Quel che imparate su un componente vale per tutti gli altri: stessi prefissi, stesse convenzioni, stessi codici di ritorno.
uo_testo.is_text = "Ciao" — nessun setter da ricordare. E la rilettura è viva: una proprietà cambiata dall'utente con il mouse si rilegge aggiornata.
Ogni proprietà a valori predefiniti espone le sue costanti sul componente: ALIGN_CENTER, THEME_MODE_DARK… completate dall'IDE, senza errori di battitura.
ue_clicked, ue_selection_changed… con i loro argomenti. Alcuni sono annullabili: il vostro codice può rifiutare il cambiamento prima che avvenga.
I metodi of_* restituiscono un long: ≥ 0 = fatto, < 0 = errore. La libreria non mostra mai una finestra al posto vostro.
Otto capitoli di guida, una pagina di riferimento per componente e una documentazione interattiva nell'applicazione dimostrativa: lì ogni proprietà ha il suo esempio eseguibile, di cui copiate il codice.
Prerequisiti, file da distribuire, integrazione nell'IDE, runtime WebView2
Aprire e migrare la demo fornita, primo componente a schermo
u_pbt_baseMotore delle proprietà, item, event, ciclo di vita, of_reset
Temi (stile × modalità), colore d'accento, override dei token, icone, testo formattato
PBT_SetLanguage, traduzioni, RTL
Tooltip, hosting di controlli PB, rilascio di file, focus da tastiera, esportazione immagine, utilità non visive
Sintomi frequenti e relative cause
Chiavi dev / runtime / demo, modalità demo
Il tutto in sei lingue — francese, inglese, tedesco, italiano, spagnolo, portoghese — in pagine HTML autonome, da leggere offline in un browser, nella cartella Documentation\ consegnata con il prodotto.
La stessa documentazione, servita al vostro assistente IA: Claude Code, Claude Desktop, Cursor o VS Code vi cercano componenti, membri ed esempi della vostra versione, e fanno verificare il PowerScript che vi propongono. Il capitolo 14 spiega come collegarlo in poche righe.
10.2 → 2025, a 32 bit come a 64 bit. Le due copie della DLL portano lo stesso nome: sviluppate nell'IDE a 32 bit e compilate a 64 bit senza cambiare una riga di PowerScript.
10 e 11, Server 2016 e successivi.
Già presente su un Windows 10/11 aggiornato. Su Server o LTSC, un bootstrapper da 2 MB lo installa una volta, in modo silenzioso.
Niente .NET, niente ActiveX, niente PBNI, nessuna registrazione COM, nessun diritto di amministratore per la libreria stessa.
No, mai. Il motore web è un dettaglio implementativo: vedete solo userobject, proprietà ed event PowerBuilder.
Il file distribuito, e nient'altro. Stesso nome di DLL, stesse dichiarazioni, stesso PowerScript.
Sì: le schede e i pannelli del dock ospitano veri controlli PB — una DataWindow, una maschera di immissione, un altro componente. È parentela Win32, non un'immagine.
Il tema è una proprietà del componente (is_theme_style × is_theme_mode, più un colore d'accento), applicata a caldo. La lingua è globale al processo: una chiamata a PBT_SetLanguage nell'open dell'applicazione, e tutti i componenti seguono.
Il capitolo FAQ e risoluzione dei problemi della documentazione consegnata elenca i sintomi frequenti e la loro causa — DLL non trovata, runtime assente, controllo posto fuori dalla finestra visibile.