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 |
| 9 | Migrar de la 1.0 a la 2.0 | Las tres reglas de la 2.0, antes/después, cada firma retirada o cambiada |
| 10 | Migrar de la 2.0 a la 3.0 | Posiciones desde 1, las direcciones de las entradas en cascada, los demás comportamientos y las novedades |
| 11 | Migrar de la 3.0 a la 4.0 | La pregunta antes de un mosaico ahora opcional, los códigos de las adiciones y los handles liberados, los demás comportamientos de la cinta y las novedades |
| 12 | Notas de la versión | Lo que cada versión aporta y corrige |
| 13 | Asistente de IA: el servidor MCP de la documentación | Su asistente de IA consulta la API exacta en lugar de inventar llamadas, y verifica el código que escribe |
Referencia de componentes #
Una página por cada componente de la biblioteca: docs/composants/.
| Categoría | Componentes |
|---|---|
| Escaparate | chartcartesian · commandpalette · ribbon |
| Contenedores y navegación | breadcrumb · dockcontainer · listbar · menubar · tab · tilesbox · toolbar |
| Barras y progreso | progressbar · statusbar · stepbar |
| Texto y entrada de datos | button · codeeditor · markdownview · speechout · soundplayer · video · jsontree · datagrid · scheduler · statictext |
| Respuesta al usuario | messagebox · toaster |
| Utilidades no visuales | crypto · restclient |
| 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(carpetasx86\yx64\). - Ninguna dependencia de .NET, ActiveX o PBNI, y ningún registro COM.
Convenciones de la API #
- Prefijos: userobjects
u_pbt_, clases de itemsn_pbt_, métodosof_, eventosue_, exportaciones de la DLLPBT_. - Todo valor gobernable es una propiedad, asignada directamente:
uo_text.is_text = "Hola". Las adiciones y las acciones siguen siendo métodos (of_add_*,of_remove_*,of_reset…). - Los métodos
of_*devuelven unlong: ≥ 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
constructorde la ventana.