# PBToolboxAI — Dokumentation #

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

Kommerzielle Bibliothek moderner visueller Komponenten (HTML/CSS/JS, gerendert von WebView2), die PowerBuilder als klassische Userobjects zur Verfügung stehen. Sie setzen ein Steuerelement, weisen typisierte Eigenschaften zu und empfangen PB-Events: kein HTML, keine URL, kein JSON, das Sie anfassen müssen.

## Entwicklerhandbuch #

# | Seite | Inhalt
--- | --- | ---
1 | Installation und Verteilung | Voraussetzungen, auszuliefernde Dateien, IDE-Integration, WebView2-Runtime
2 | Erste Schritte | Die gelieferte Demo öffnen und migrieren, erste Komponente auf dem Bildschirm
3 | Gemeinsame Basis `u_pbt_base` | Eigenschaften-Engine, Items, Events, Lebenszyklus, `of_reset`
4 | Designs und Erscheinungsbild | Designs (Stil × Modus), Akzentfarbe, Token-Overrides, Symbole, Rich-Text
5 | Sprache und Leserichtung | `PBT_SetLanguage`, Übersetzungen, RTL
6 | Übergreifende Funktionen | Tooltips, Hosting von PB-Steuerelementen, Datei-Drop, Tastaturfokus, Bildexport, nicht visuelle Hilfsmittel
7 | FAQ und Fehlerbehebung | Häufige Symptome und ihre Ursachen
8 | Lizenz und Demomodus | Schlüssel `dev` / `runtime` / `demo`, Demomodus

## Komponentenreferenz #

Eine Seite je Komponente der Version 1: docs/composants/.

Kategorie | Komponenten
--- | ---
Schaufenster | ribbon
Container und Navigation | dockcontainer · listbar · tab · tilesbox · toolbar
Leisten und Fortschritt | progressbar · statusbar
Text und Eingabe | button · codeeditor · statictext
Benutzer-Feedback | messagebox · toaster
Medien und Viewer | pdfviewer · picture · webbrowser

## Was Sie erhalten #

Datei | Zweck
--- | ---
`pbtoolboxai.dll` (x86 / x64) | Eigenständige Engine (Web-Bundles, Designs und Wörterbücher eingebettet)
`pbtoolboxai.pbl` | Userobjects `u_pbt_*`, Item-Klassen `n_pbt_*`, External-Function-Deklarationen
`pbtoolboxai_demo` | Demoanwendung (Schaufenster, Codebeispiele, interaktive Dokumentation)
`docs/` | Diese Dokumentation
WebView2-Bootstrapper (optional) | Für die seltenen Rechner ohne die Runtime

## Kompatibilität #

- PowerBuilder: 10.2 → 2025.
- Windows: 10 und 11 (WebView2-Runtime vorinstalliert). Windows Server / LTSC: Runtime installieren, siehe Installation.
- 32 Bit und 64 Bit: Beide Exemplare werden unter demselben Namen ausgeliefert, `pbtoolboxai.dll` (Ordner `x86\` und `x64\`).
- Keine Abhängigkeit von .NET, ActiveX oder PBNI und keine COM-Registrierung.

## Konventionen der API #

- Präfixe: Userobjects `u_pbt_`, Item-Klassen `n_pbt_`, Methoden `of_`, Events `ue_`, DLL-Exporte `PBT_`.
- Jeder steuerbare Wert ist eine Eigenschaft und wird direkt zugewiesen: `uo_texte.is_text = "Guten Tag"`. Hinzufügen und Aktionen bleiben Methoden (`of_add_*`, `of_remove_*`, `of_reset`…).
- Die Methoden `of_*` liefern einen `long` zurück: ≥ 0 = OK, < 0 = Fehler (`-2`: Komponente nicht erstellt; `-5`: ungültiges Argument). `of_get_last_error()` liefert die Einzelheiten.
- Befehle, die abgesetzt werden, bevor die Komponente bereit ist, werden in eine Warteschlange gestellt und automatisch nachgeholt: Sie können alles bereits im `constructor` des Fensters konfigurieren.