9. Migrar de la 1.0 a la 2.0 #

← Licencia y modo demo · Índice · Migrar de la 2.0 a la 3.0 →

La 2.0 aporta cinco componentes y remodela la API de los dieciséis de la 1.0. La remodelación se resume en tres reglas; casi todos los errores de compilación que verá se derivan de ellas. Esta página da las reglas, un antes/después y luego, componente por componente, cada firma retirada o cambiada. Los componentes ausentes de las tablas — button, messagebox, picture, pdfviewer, progressbar, webbrowser — no han perdido nada.

9.1 Las tres reglas #

1. Una clave, una dirección. El identificador de un item se llama as_key — un solo nivel, único bajo su padre. Un item anidado se alcanza mediante una dirección as_keys, los niveles unidos por /: "home/clipboard/paste". Los eventos devuelven esa dirección en un argumento, donde la 1.0 pasaba tres (as_tab, as_group, as_id). Para dividirla: n_pbt_utils.of_split_path (as_keys, ref as_out[]).

2. Todo se hace desde el componente. Un handle (n_pbt_ribbon_group, n_pbt_toolbar_bar, n_pbt_tilesbox_group, n_pbt_listbar_section…) ya no añade nada: las adiciones y supresiones están en el componente, con la dirección del padre. Los getters llevan el nombre del nivel — of_tab, of_group, of_item, of_menu_item en la cinta, of_panel en el dock y la barra de estado, of_page en el tab, of_section en la listbar, of_bar en la toolbar, of_tile en el tilesbox. Un handle solo sirve ya para leer y establecer propiedades.

3. Una adición devuelve un código, no un handle. of_add_tab, of_add_group, of_add_bar, of_add_section… devuelven un long: 0 una vez aplicado, -5 ante una dirección errónea (padre ausente, o de otra naturaleza, clave vacía), -2 si el componente no está creado. Un handle no podía decir que había rechazado; un código sí. Cuando hay que establecer una propiedad, el getter da el handle justo después.

9.2 Antes / después #

// 1.0
n_pbt_ribbon_tab   lnv_tab
n_pbt_ribbon_group lnv_group
lnv_tab   = uo_ribbon.of_add_tab("home", "Home")
lnv_group = lnv_tab.of_add_group("clip", "Clipboard")
lnv_group.of_add_button("paste", "Paste", "img/paste.svg")
lnv_group.of_item("paste").ib_enabled = false

// 2.0
uo_ribbon.of_add_tab("home", "Home")
uo_ribbon.of_add_group("home/clip", "Clipboard")
uo_ribbon.of_add_button("home/clip/paste", "Paste", "img/paste.svg")
uo_ribbon.of_item("home/clip/paste").ib_enabled = false

Y el evento resultante:

// 1.0
event ue_clicked (string as_tab, string as_group, string as_id)
   if as_tab = "home" and as_group = "clip" and as_id = "paste" then ...

// 2.0
event ue_clicked (string as_keys)
   if as_keys = "home/clip/paste" then ...

Las propiedades de los handles (ib_enabled, is_text, is_image, ib_visible…) y el motor de propiedades no cambian: lo que cambia es la forma de alcanzar el handle, no lo que se hace con él.

9.3 La receta #

1. Migre una copia de sus bibliotecas, como para cualquier cambio de versión de PowerBuilder — véase Primeros pasos. Sustituya pbtoolboxai.pbl por el de la 2.0.
2. Lance un Full Build. Cada llamada que corregir sale como error de compilación, con el objeto y el script: la lista está completa a la primera, no hay nada que adivinar.
3. Corrija las llamadas con las tablas de la sección 9.4: un handle que añadía se convierte en el componente más la dirección; un lnv_x = of_add_… pasa a ser una llamada sin asignación, y el handle se toma después del getter del nivel.
4. En sus scripts de eventos los argumentos cambiaron de nombre y de número — as_tab, as_group, as_id pasan a ser as_keys. PowerBuilder señala cada referencia a un argumento desaparecido; sustituya la comparación de tres valores por la de una dirección.
5. Las funciones internas renombradas a xx_ (of_on_item_property, of_ensure_created, xx_of_send, el of_init de los handles) solo le afectan si ha derivado un componente o un handle y redefinido una de ellas.

9.4 Componente a componente #

En las tablas, lnv_tab, lnv_group, lnv_item, lnv_bar, lnv_section, lnv_tile designan un handle de la 1.0; uo el componente. Una dirección entre comillas muestra los niveles esperados. Los parámetros sin cambios se abrevian con ….

Base común (todos los componentes) #

Ribbon #

Toolbar #

Tiles box #

Listbar #

Statusbar #

Tab #

Dock container #

Toaster, Statictext, Code editor #

← Licencia y modo demo · Índice · Migrar de la 2.0 a la 3.0 →