# 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

## Riferimento dei componenti #

Una pagina per ogni componente della versione 1: docs/composants/.

Categoria | Componenti
--- | ---
Vetrina | ribbon
Contenitori e navigazione | dockcontainer · listbar · tab · tilesbox · toolbar
Barre e avanzamento | progressbar · statusbar
Testo e immissione | button · codeeditor · statictext
Riscontro all'utente | messagebox · toaster
Contenuti multimediali e visualizzatori | pdfviewer · picture · 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_texte.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.