9. Von 1.0 auf 2.0 migrieren #

← Lizenz und Demomodus · Inhalt · Von 2.0 auf 3.0 migrieren →

2.0 bringt fünf Komponenten und gestaltet die API der sechzehn aus 1.0 um. Die Umgestaltung lässt sich auf drei Regeln zurückführen; fast jeder Kompilierfehler, den Sie sehen werden, folgt daraus. Diese Seite nennt die Regeln, ein Vorher/Nachher und dann, Komponente für Komponente, jede entfernte oder geänderte Signatur. Die in den Tabellen fehlenden Komponenten — button, messagebox, picture, pdfviewer, progressbar, webbrowser — haben nichts verloren.

9.1 Die drei Regeln #

1. Ein Schlüssel, eine Adresse. Der Bezeichner eines Items heißt as_key — eine Ebene, eindeutig unter seinem Elternelement. Ein verschachteltes Item wird über eine Adresse as_keys erreicht, die Ebenen durch / verbunden: "home/clipboard/paste". Events geben diese Adresse in einem Argument zurück, wo 1.0 drei übergab (as_tab, as_group, as_id). Zum Zerlegen: n_pbt_utils.of_split_path (as_keys, ref as_out[]).

2. Alles geschieht von der Komponente aus. Ein Handle (n_pbt_ribbon_group, n_pbt_toolbar_bar, n_pbt_tilesbox_group, n_pbt_listbar_section…) fügt nichts mehr hinzu: Hinzufügen und Entfernen liegen auf der Komponente, mit der Adresse des Elternelements. Die Getter tragen den Namen der Ebene — of_tab, of_group, of_item, of_menu_item beim Menüband, of_panel beim Dock und der Statusleiste, of_page beim Tab, of_section bei der Listbar, of_bar bei der Symbolleiste, of_tile bei der Tiles-Box. Ein Handle dient nur noch dem Lesen und Setzen von Eigenschaften.

3. Ein Hinzufügen liefert einen Code, kein Handle. of_add_tab, of_add_group, of_add_bar, of_add_section… liefern ein long: 0 nach der Anwendung, -5 bei einer falschen Adresse (Elternelement fehlt oder ist von anderer Art, leerer Schlüssel), -2 wenn die Komponente nicht erzeugt ist. Ein Handle konnte nicht sagen, dass es abgelehnt hatte; ein Code kann das. Soll eine Eigenschaft gesetzt werden, gibt der Getter das Handle gleich danach.

9.2 Vorher / nachher #

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

Und das daraus folgende Event:

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

Die Eigenschaften der Handles (ib_enabled, is_text, is_image, ib_visible…) und die Eigenschaften-Engine sind unverändert: Was sich ändert, ist der Weg zum Handle, nicht, was man damit tut.

9.3 Das Rezept #

1. Migrieren Sie eine Kopie Ihrer Bibliotheken, wie bei jedem PowerBuilder-Versionswechsel — siehe Erste Schritte. Ersetzen Sie pbtoolboxai.pbl durch das der 2.0.
2. Starten Sie einen Full Build. Jeder zu korrigierende Aufruf erscheint als Kompilierfehler, mit Objekt und Skript: Die Liste ist beim ersten Durchlauf vollständig, nichts ist zu erraten.
3. Korrigieren Sie die Aufrufe mit den Tabellen aus Abschnitt 9.4: Ein Handle, das hinzufügte, wird zur Komponente plus Adresse; ein lnv_x = of_add_… wird zu einem bloßen Aufruf, und das Handle holt man danach über den Getter der Ebene.
4. In Ihren Event-Skripten haben sich Name und Anzahl der Argumente geändert — aus as_tab, as_group, as_id wird as_keys. PowerBuilder meldet jede Referenz auf ein verschwundenes Argument; ersetzen Sie den Dreifachvergleich durch einen Adressvergleich.
5. Die in xx_ umbenannten internen Funktionen (of_on_item_property, of_ensure_created, xx_of_send, das of_init der Handles) betreffen Sie nur, wenn Sie eine Komponente oder ein Handle abgeleitet und eine davon überschrieben haben.

9.4 Komponente für Komponente #

In den Tabellen stehen lnv_tab, lnv_group, lnv_item, lnv_bar, lnv_section, lnv_tile für ein Handle der 1.0; uo für die Komponente. Eine Adresse in Anführungszeichen zeigt die erwarteten Ebenen. Unveränderte Parameter sind zu … gekürzt.

Gemeinsame Basis (jede Komponente) #

Ribbon #

Toolbar #

Tiles box #

Listbar #

Statusbar #

Tab #

Dock container #

Toaster, Statictext, Code editor #

← Lizenz und Demomodus · Inhalt · Von 2.0 auf 3.0 migrieren →