PBToolboxAI — Documentation #

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

A commercial library of modern visual components (HTML/CSS/JS rendered by WebView2) exposed to PowerBuilder as plain userobjects. You drop a control, assign typed properties, receive PB events: no HTML, no URL, no JSON to handle.

Developer guide #

#	Page	Contents
1	Installation and deployment	Requirements, files to ship, IDE integration, WebView2 runtime
2	Getting started	Open and migrate the shipped demo, first component on screen
3	Shared foundation `u_pbt_base`	Property engine, items, events, life cycle, `of_reset`
4	Themes and appearance	Themes (style × mode), accent color, token overrides, icons, rich text
5	Language and reading direction	`PBT_SetLanguage`, translations, RTL
6	Cross-cutting features	Tooltips, hosting PB controls, file drop, keyboard focus, image export, non-visual utilities
7	FAQ and troubleshooting	Common symptoms and what causes them
8	License and demo mode	`dev` / `runtime` / `demo` keys, demo mode
9	Migrating from 1.0 to 2.0	The three rules of 2.0, before/after, every signature removed or changed
10	Migrating from 2.0 to 3.0	Positions from 1, the addresses of cascaded entries, the other behaviours and the additions
11	Migrating from 3.0 to 4.0	The question before a tile now opt-in, the codes of the adds and the freed handles, the other ribbon behaviours and the additions
12	Release notes	What each release brings and fixes
13	AI assistant: the documentation MCP server	Your AI assistant looks up the exact API instead of inventing calls, and checks the code it writes

Component reference #

One page per library component: docs/composants/.

Category	Components
Showcase	chartcartesian · commandpalette · ribbon
Containers and navigation	breadcrumb · dockcontainer · listbar · menubar · tab · tilesbox · toolbar
Bars and progress	progressbar · statusbar · stepbar
Text and input	button · codeeditor · markdownview · speechout · soundplayer · video · jsontree · datagrid · scheduler · statictext
User feedback	messagebox · toaster
Non-visual utilities	crypto · restclient
Media and viewers	pdfviewer · picture · webbrowser

What you get #

File	Purpose
`pbtoolboxai.dll` (x86 / x64)	Self-contained engine (web bundles, themes and dictionaries embedded)
`pbtoolboxai.pbl`	`u_pbt_` userobjects, `n_pbt_` item classes, external function declarations
`pbtoolboxai_demo`	Demo application (showcase, code samples, interactive documentation)
`docs/`	This documentation
WebView2 bootstrapper (optional)	For the rare machines without the runtime

Compatibility #

PowerBuilder: 10.2 → 2025.
Windows: 10 and 11 (WebView2 runtime preinstalled). Windows Server / LTSC: install the runtime, see Installation.
32-bit and 64-bit: both copies ship under the same name, pbtoolboxai.dll (folders x86\ and x64\).
No .NET, ActiveX or PBNI dependency, and no COM registration.

API conventions #

Prefixes: userobjects u_pbt_, item classes n_pbt_, methods of_, events ue_, DLL exports PBT_.
Every value you can drive is a property, assigned directly: uo_text.is_text = "Hello". Additions and actions remain methods (of_add_*, of_remove_*, of_reset…).
The of_* methods return a long: ≥ 0 = OK, < 0 = error (-2: component not created; -5: invalid argument). of_get_last_error() gives the details.
Commands issued before the component is ready are queued and replayed automatically: you can configure everything right from the window constructor.