9. Migrare dalla 1.0 alla 2.0 #

← Licenza e modalità demo · Sommario · Migrare dalla 2.0 alla 3.0 →

La 2.0 porta cinque componenti e rimodella l'API dei sedici della 1.0. Il rimodellamento si riduce a tre regole; quasi tutti gli errori di compilazione che vedrà ne derivano. Questa pagina espone le regole, un prima/dopo, poi, componente per componente, ogni firma rimossa o cambiata. I componenti assenti dalle tabelle — button, messagebox, picture, pdfviewer, progressbar, webbrowser — non hanno perso nulla.

9.1 Le tre regole #

1. Una chiave, un indirizzo. L'identificatore di un item si chiama as_key — un solo livello, unico sotto il suo genitore. Un item annidato si raggiunge tramite un indirizzo as_keys, i livelli uniti da /: "home/clipboard/paste". Gli event restituiscono quell'indirizzo in un argomento, dove la 1.0 ne passava tre (as_tab, as_group, as_id). Per scomporlo: n_pbt_utils.of_split_path (as_keys, ref as_out[]).

2. Tutto si fa dal componente. Un handle (n_pbt_ribbon_group, n_pbt_toolbar_bar, n_pbt_tilesbox_group, n_pbt_listbar_section…) non aggiunge più nulla: aggiunte e rimozioni stanno sul componente, con l'indirizzo del genitore. I getter portano il nome del livello — of_tab, of_group, of_item, of_menu_item sulla barra multifunzione, of_panel sul dock e sulla barra di stato, of_page sul tab, of_section sulla listbar, of_bar sulla toolbar, of_tile sul tilesbox. Un handle serve ormai solo a leggere e impostare proprietà.

3. Un'aggiunta restituisce un codice, non un handle. of_add_tab, of_add_group, of_add_bar, of_add_section… restituiscono un long: 0 una volta applicato, -5 su un indirizzo errato (genitore assente, o di altra natura, chiave vuota), -2 se il componente non è creato. Un handle non poteva dire di aver rifiutato; un codice sì. Quando c'è una proprietà da impostare, il getter dà l'handle subito dopo.

9.2 Prima / dopo #

// 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

E l'event che ne deriva:

// 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 ...

Le proprietà degli handle (ib_enabled, is_text, is_image, ib_visible…) e il motore delle proprietà sono invariati: ciò che cambia è il modo di raggiungere l'handle, non ciò che se ne fa.

9.3 La ricetta #

1. Migri una copia delle Sue librerie, come per ogni cambio di versione di PowerBuilder — vedere Primi passi. Sostituisca pbtoolboxai.pbl con quello della 2.0.
2. Lanci un Full Build. Ogni chiamata da correggere esce come errore di compilazione, con l'oggetto e lo script: l'elenco è completo al primo passaggio, non c'è nulla da indovinare.
3. Corregga le chiamate con le tabelle della sezione 9.4: un handle che aggiungeva diventa il componente più l'indirizzo; un lnv_x = of_add_… diventa una chiamata nuda, e l'handle si prende poi dal getter del livello.
4. Nei Suoi script di event gli argomenti hanno cambiato nome e numero — as_tab, as_group, as_id diventano as_keys. PowerBuilder segnala ogni riferimento a un argomento scomparso; sostituisca il confronto di tre valori con quello di un indirizzo.
5. Le funzioni interne rinominate in xx_ (of_on_item_property, of_ensure_created, xx_of_send, l'of_init degli handle) La riguardano solo se ha derivato un componente o un handle e ridefinito una di esse.

9.4 Componente per componente #

Nelle tabelle, lnv_tab, lnv_group, lnv_item, lnv_bar, lnv_section, lnv_tile indicano un handle della 1.0; uo il componente. Un indirizzo tra virgolette mostra i livelli attesi. I parametri invariati sono abbreviati in ….

Base comune (tutti i componenti) #

Ribbon #

Toolbar #

Tiles box #

Listbar #

Statusbar #

Tab #

Dock container #

Toaster, Statictext, Code editor #

← Licenza e modalità demo · Sommario · Migrare dalla 2.0 alla 3.0 →