# PBToolboxAI — Documentación #

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

Biblioteca comercial de componentes visuales modernos (HTML/CSS/JS representados por WebView2) expuestos a PowerBuilder como userobjects clásicos. Usted coloca un control, asigna propiedades tipadas y recibe eventos PB: ningún HTML, ninguna URL, ningún JSON que manipular.

## Guía del desarrollador #

# | Página | Contenido
--- | --- | ---
1 | Instalación e implementación | Requisitos previos, archivos que entregar, integración en el IDE, runtime WebView2
2 | Primeros pasos | Abrir y migrar la demo entregada, primer componente en pantalla
3 | Base común `u_pbt_base` | Motor de propiedades, items, eventos, ciclo de vida, `of_reset`
4 | Temas y apariencia | Temas (estilo × modo), color de acento, anulación de tokens, iconos, texto enriquecido
5 | Idioma y sentido de lectura | `PBT_SetLanguage`, traducciones, RTL
6 | Funciones transversales | Tooltips, alojamiento de controles PB, arrastre de archivos, foco de teclado, exportación de imagen, utilidades no visuales
7 | FAQ y resolución de problemas | Síntomas frecuentes y sus causas
8 | Licencia y modo demo | Claves `dev` / `runtime` / `demo`, modo demo

## Referencia de componentes #

Una página por cada componente de la versión 1: docs/composants/.

Categoría | Componentes
--- | ---
Escaparate | ribbon
Contenedores y navegación | dockcontainer · listbar · tab · tilesbox · toolbar
Barras y progreso | progressbar · statusbar
Texto y entrada de datos | button · codeeditor · statictext
Respuesta al usuario | messagebox · toaster
Multimedia y visores | pdfviewer · picture · webbrowser

## Lo que usted recibe #

Archivo | Función
--- | ---
`pbtoolboxai.dll` (x86 / x64) | Motor autónomo (bundles web, temas y diccionarios incorporados)
`pbtoolboxai.pbl` | Userobjects `u_pbt_*`, clases de items `n_pbt_*`, declaraciones external functions
`pbtoolboxai_demo` | Aplicación de demostración (escaparate, ejemplos de código, documentación interactiva)
`docs/` | Esta documentación
Bootstrapper WebView2 (opcional) | Para los escasos equipos sin el runtime

## Compatibilidad #

- PowerBuilder: 10.2 → 2025.
- Windows: 10 y 11 (runtime WebView2 preinstalado). Windows Server / LTSC: instalar el runtime, véase Instalación.
- 32 bits y 64 bits: ambas copias se entregan con el mismo nombre, `pbtoolboxai.dll` (carpetas `x86\` y `x64\`).
- Ninguna dependencia de .NET, ActiveX o PBNI, y ningún registro COM.

## Convenciones de la API #

- Prefijos: userobjects `u_pbt_`, clases de items `n_pbt_`, métodos `of_`, eventos `ue_`, exportaciones de la DLL `PBT_`.
- Todo valor gobernable es una propiedad, asignada directamente: `uo_texte.is_text = "Hola"`. Las adiciones y las acciones siguen siendo métodos (`of_add_*`, `of_remove_*`, `of_reset`…).
- Los métodos `of_*` devuelven un `long`: ≥ 0 = OK, < 0 = error (`-2`: componente no creado; `-5`: argumento no válido). `of_get_last_error()` da el detalle.
- Los comandos emitidos antes de que el componente esté listo se ponen en cola y se reproducen automáticamente: usted puede configurarlo todo ya en el `constructor` de la ventana.