12. Von 4.0 auf 5.0 migrieren #

← Von 3.0 auf 4.0 migrieren · Inhalt · Versionshinweise →

5.0 ändert keine Signatur der siebenunddreißig Komponenten aus 4.0, auch kein Event — außer der Schaltflächenleiste (buttonbar, 12.7) und dem Event ue_link_clicked des Markdown-Viewers (markdownview), das ein zweites Argument erhält, as_kind (12.5). Drei Komponenten wechseln ihre Wörter. Der Fortschrittsbalken (progressbar) übernimmt die der Anzeigen — ib_label, il_color und is_label_format entfallen zugunsten von ib_show_value, il_value_color, is_format und is_unit (12.1). Das kartesische Diagramm (chartcartesian) schreibt seine Zahlen über is_format, wie die Anzeigen und das Kreisdiagramm: of_set_value_format und of_clear_value_format entfallen, und ii_point_count einer Reihe wird zu il_point_count (12.4). Die Kreuztabelle (crosstab) geht denselben Weg: of_set_value_format und of_clear_value_format entfallen zugunsten von is_format — auf dem Feld oder über of_value auf einem einzelnen Wert — und von ib_negative_red (12.8). Der Compiler zeigt Ihnen jede Zeile, die anzupassen ist. Die Seitenleiste (listbar) ändert ein Ereignis: ue_item_rclicked erhält zusätzlich den Bildschirmpunkt des Klicks, al_x und al_y (12.9). Das Kachel-Panel (tilesbox) benennt ein Ereignis um: ue_tile_context(as_keys) wird zu ue_tile_rclicked(as_keys, al_x, al_y), und die Position von of_move_tile und of_insert_tile wird zu long al_position (12.12). Das radiale Menü (radialmenu) verliert vier Tooltip-Eigenschaften, die es nie angezeigt hat — is_tooltip, is_super_tooltip_title, is_super_tooltip_text und is_super_tooltip_image (12.5). Der Kalender (scheduler) ändert drei Gesten-Events: ue_appointment_changing erhält as_kind, ue_appointment_moved und ue_appointment_resized erhalten die bisherigen Werte (12.10). Der Shell-Explorer (shellexplorer) ändert ein Ereignis: ue_error erhält zusätzlich den Pfad und einen konstanten Grund, as_path und as_reason (12.11). Der Rich-Text-Block (statictext) ändert ein Ereignis: ue_hyperlink erhält zusätzlich ab_opened, ob sich der Link wirklich geöffnet hat (12.5). Die Registerkarte (tab) ändert ein Ereignis: ue_tab_rclicked erhält zusätzlich den Bildschirmpunkt des Klicks, al_x und al_y (12.13). Der Soundplayer (soundplayer) ändert drei Ereignisse: ue_started, ue_ended und ue_failed erhalten zusätzlich die Nummer des Tons, al_sound (12.14). Der Toaster (toaster) ändert ein Ereignis: ue_toast_dismissed erhält zusätzlich den Grund des Schließens, as_reason (12.15). Der Webbrowser (webbrowser): of_go_back, of_go_forward und of_stop geben einen long zurück, und unter ib_veto_navigation wird eine vom Benutzer getippte Adresse bei ue_navigating erfragt (12.17). Die Symbolleiste (toolbar) ändert ein Ereignis: ue_item_rclicked erhält zusätzlich den Bildschirmpunkt des Klicks, al_x und al_y (12.18). Der Videoplayer (video) ändert eine Signatur: of_stop wird eine Funktion, die einen long zurückgibt (12.16) — ein als Anweisung geschriebener Aufruf kompiliert weiterhin. Drei Komponenten ändern ein Rechtsklick-Ereignis eines Elements, das zusätzlich seinen Bildschirmpunkt al_x, al_y erhält: die Schaltflächenleiste (ue_button_rclicked), der Brotkrumenpfad (breadcrumb, ue_item_rclicked) und das kartesische Diagramm (ue_point_rclicked); die Statusleiste (statusbar) liefert diesen Punkt wie die anderen, nicht mehr mit der Skalierung des Bildschirms multipliziert (12.19). Die Basis (12.20): Der Grund für das Scheitern einer nicht visuellen Komponente wird über of_get_last_error() gelesen — die Eigenschaft is_last_error verschwindet aus crypto, restclient, soundplayer, speechout, xml, u_pbt_regex und u_pbt_zip —, und of_stop, of_close und of_reset der nicht visuellen Komponenten liefern einen long.

Der Rest verlangt nichts von Ihrem Code: Das Datenraster (datagrid) und das Menüband (ribbon) erhalten numerische Eingabemasken, und der Editor einer numerischen Spalte des Rasters öffnet sich jetzt mit dem Text der Maske (12.2, 12.3). Die neuen Komponenten der 5.0 werden in den Versionshinweisen vorgestellt.

12.1 progressbar: die Wörter der Anzeigen #

5.0 bringt zwei Anzeigen, linear (gauge) und mit Zifferblatt (angulargauge). Auch ein Fortschrittsbalken zeigt einen Wert auf einer Skala: Die Bibliothek spricht dafür nur noch eine Sprache, und der Balken, der dasselbe mit anderen Worten sagte, übernimmt die Wörter der Anzeigen. Kein alter Name bleibt: weder eine Eigenschaft noch ein von of_set_property akzeptierter Name.

• is_format ist ein PowerBuilder-Anzeigeformat, das auf den Wert angewendet wird ("#,##0", "$#,##0.00"), mit den Trennzeichen der Anzeigesprache, genau wie bei den Anzeigen. Leer zeigt der Balken den Prozentsatz, wie bisher.
• Die Platzhalter {percent}, {value}, {min} und {max} gibt es nicht mehr. Eine Beschriftung, die Wert und Prozentsatz mischte ("{value} of {max} rows ({percent})"), hat keine genaue Entsprechung: Wählen Sie den Wert (Format und Einheit) oder den Prozentsatz (und eine Einheit). Das Maximum, das Ihr Code kennt, wird in die Einheit geschrieben.
• is_unit ist neu: ein reiner Text, der nach dem Ablesewert geschrieben wird, durch ein Leerzeichen getrennt — nach dem Wert wie nach dem Prozentsatz. of_reset leert ihn.
• Eine Maske mit % schreibt den erledigten Anteil, nicht den Wert: is_format = "0.0%" ergibt „35.0%“ für 1.687 von 4.820 Zeilen, abgerundet wie der Prozentsatz — der Prozentsatz mit Nachkommastellen, den {percent} nicht schreiben konnte.
• Ein pausiertes oder fehlgeschlagenes Warten wird zu einem vollen Balken. In 4.0 erstarrte ein Wartebalken (ib_indeterminate), der STATE_PAUSED oder STATE_ERROR erhielt, mitten im Gleiten, oft außerhalb seiner Spur: Der Fehler war nicht zu sehen. In 5.0 hält er als voller Balken (voller Ring) in der Statusfarbe an, wie die Windows-Taskleiste, und der Bildschirmleser meldet ihn nicht mehr als beschäftigt, sondern nennt seinen Status.
• of_set_property("tooltip", …) und super_tooltip_* liefern -5: Der Balken veröffentlicht keinen Tooltip, und der Weg über den Namen, der einen setzte, ist wie die Eigenschaften geschlossen.
• Neu, ohne etwas anzupassen: is_orientation (ORIENTATION_VERTICAL: ein senkrechter Balken anstelle einer VProgressBar), is_accessible_name (der Name, den der Bildschirmleser sagt) und der Text eines Wartens (nur is_unit, während der Balken wartet).

// 4.0 : the label wrote the value through placeholders
uo_progress.ib_label        = true
uo_progress.il_color        = RGB(/*red*/ 0, /*green*/ 120, /*blue*/ 215)
uo_progress.is_label_format = "{value} of {max} rows"

// 5.0 : the words of the gauges - a display format for the value, then a unit
uo_progress.ib_show_value  = true
uo_progress.il_value_color = RGB(/*red*/ 0, /*green*/ 120, /*blue*/ 215)
uo_progress.is_format      = "#,##0"
uo_progress.is_unit        = "of 500 rows"

Das Rezept: Kompilieren Sie; jedes ib_label, il_color und is_label_format eines Fortschrittsbalkens wird gemeldet. Ersetzen Sie die ersten beiden durch ib_show_value und il_value_color. Für das dritte: Ein leerer Text bleibt in is_format leer; eine Beschriftung, die den Wert schrieb, wird zu einem Format ("#,##0") und einer Einheit; eine Beschriftung, die den Prozentsatz schrieb, lässt is_format leer und legt ihren Text in is_unit. Ein of_set_property, das label, label_format oder color nannte, liefert jetzt -5 und bewirkt nichts (of_get_last_error nennt die Eigenschaft): Suchen Sie diese Namen in Ihrem Code.

12.2 datagrid: ein numerischer Editor, der über eine Maske tippt #

Keine Signatur ändert sich, und ue_cell_edited erhält weiterhin die reine Zahl (1234.5). Was sich ändert, sieht man am Bildschirm: Die Eingabe in einer numerischen Spalte folgt jetzt einer Eingabemaske in der Syntax des DataWindows — der, die Sie über die neue Eigenschaft is_mask der Spalte angeben, sonst ihrem Anzeigeformat ohne seine Literale.

// 5.0 : the input mask of a numeric column - the cell still receives the bare number
uo_grid.of_column(/*key*/ "revenue").is_mask = "#,##0.00"

Das Rezept: nichts zu ändern. Code, der den getippten Text las, sieht ihn nicht: ue_cell_edited liefert weiterhin die Zahl. Eine Spalte, deren Eingabe frei bleiben muss (ein Code, eine Teilenummer), ist eine Textspalte, keine numerische.

12.3 ribbon: die Masken eines Drehfelds #

Für ein Drehfeld ohne Maske ändert sich nichts. Zwei neue Eigenschaften seines Handles, in der Syntax von PowerBuilder: is_mask, die Eingabemaske ("#,##0.00", "0%"), und is_format, das Anzeigeformat mit seinen Literalen (0 "pt" zeigt 11 pt, getippt 11). id_value und ue_value_changed behalten die reine Zahl, der Wechsel zwischen beiden löst kein Event aus, und die Masken folgen dem Drehfeld in den Bereich einer eingeklappten Gruppe.

// 5.0 : a font size shown "11 pt", typed "11"
uo_ribbon.of_item(/*keys*/ "home/font/size").is_format = "0 ~"pt~""

Das Rezept: nichts zu ändern.

12.4 chartcartesian: das Zahlenformat über is_format #

Das kartesische Diagramm schrieb seine Zahlen über eine Funktion mit vier Argumenten (Dezimalstellen, Präfix, Suffix, Tausendertrennzeichen). 5.0 stellt Diagramme und Anzeigen unter eine einzige Sprache: ein PowerBuilder-Anzeigeformat, das einer DataWindow-Spalte, in der Eigenschaft is_format — des ganzen Diagramms und einer Achse über ihren Handle. Die Abschnitte positiv;negativ;null, die Literale und der Prozentsatz kommen mit, und die Trennzeichen bleiben die der Anzeigesprache. Kein alter Name bleibt.

• Das Format einer Achse geht dem des Diagramms vor und bleibt. Das Format des Diagramms zu setzen löscht das der Achsen nicht mehr (die Form von of_set_value_format ohne Achse tat es): Eine Achse kehrt mit is_format = "" zum Format des Diagramms zurück.
• Ohne Format (leer oder ein nicht numerisches Format) wird die Zahl so geschrieben, wie sie ist, auf das Tausendstel, mit dem Dezimaltrennzeichen der Anzeigesprache — wie es das Standardformat tat.

// 4.0 : decimals, prefix, suffix and thousands as four arguments
uo_chart.of_set_value_format(/*decimals*/ 0, /*prefix*/ "$", /*suffix*/ "K", /*thousands*/ true)
uo_chart.of_set_value_format(/*axis*/ u_pbt_chartcartesian.AXIS_VALUE2, /*decimals*/ 1, /*prefix*/ "", /*suffix*/ " u", /*thousands*/ false)

// 5.0 : a display format, written as in a DataWindow - for the chart, then for one axis
uo_chart.is_format = "$#,##0K"
uo_chart.of_axis(/*axis*/ u_pbt_chartcartesian.AXIS_VALUE2).is_format = '0.0" u"'

Das Rezept: Kompilieren Sie; jedes of_set_value_format und of_clear_value_format wird gemeldet. Schreiben Sie das Format wie in einem DataWindow: decimals gibt die Zahl der 0 nach dem Punkt (-1 = #,##0.###), thousands das Gruppierungs-,, Präfix und Suffix stehen davor und dahinter (in Anführungszeichen, wenn sie Ziffern oder Leerzeichen enthalten). Das Format einer Achse gehört in of_axis(<Achse>).is_format.

12.5 Weitere Verhaltensweisen, die Sie bemerken können #

Das Rezept: nichts zu ändern.

12.6 Was hinzugekommen ist #

Nichts davon verlangt eine Änderung Ihres Codes. Die acht neuen Komponenten der 5.0 werden in den Versionshinweisen vorgestellt.

12.7 buttonbar: Schlüssel, Beschriftung, dann Symbol; das „&“ und das Kürzel #

Die Schaltflächenleiste sprach anders als der Rest der Bibliothek: das Symbol vor der Beschriftung, die Position als zweites Argument und ein is_shortcut, das „Alt-Buchstabe“ bedeutete, wo es überall sonst „Kürzel“ bedeutet — is_shortcut = "Ctrl+S" belegte Alt+C. 5.0 gleicht sie an button, die Symbolleiste und den CommandButton von PowerBuilder an.

• is_shortcut einer Schaltfläche ist ein Kürzel. Während 5.0 wird ein einzelner Buchstabe dort noch als Alt-Buchstabe von 4.0 gelesen (er geht in is_mnemonic); schreiben Sie stattdessen das „&“ in die Beschriftung. Ein Kürzel, das das Fenster nie auslösen kann (ein Buchstabe allein, Ctrl+Shift), wird abgelehnt: is_shortcut liefert leer, of_register_shortcut liefert -5.
• Eine deaktivierte Schaltfläche stiehlt keine Taste mehr. Die deaktivierte Standardschaltfläche einer Leiste oder der Alt-Buchstabe einer deaktivierten Schaltfläche lässt Enter und den Buchstaben beim Fenster — sie gehen nicht mehr an die Schaltfläche einer ANDEREN Leiste (zwei MDI-Blätter); das Kürzel einer deaktivierten Schaltfläche lässt seine Taste beim Fenster (etwa einem Menü-Accelerator). Die Pfeiltasten überspringen eine deaktivierte Schaltfläche.

// 4.0 : the icon before the label
uo_bar.of_add_button(/*key*/ "save", /*image_file*/ "img\save.png", /*text*/ "Save")

// The Alt letter went to is_shortcut (the letter S alone), the chord to of_register_shortcut
uo_bar.of_register_shortcut(/*chord*/ "Ctrl+S", /*key*/ "save")

// 5.0 : key, label, icon - the "&" of the label gives Alt+S
uo_bar.of_add_button(/*key*/ "save", /*text*/ "&Save", /*image*/ "img\save.png")

// The chord is a property of the button, shown in its tooltip
uo_bar.of_button(/*key*/ "save").is_shortcut = "Ctrl+S"

Das Rezept: Kompilieren Sie; ein Aufruf von of_insert_button wird gemeldet (die Position kommt zuletzt). Ein of_add_button mit drei Argumenten kompiliert weiterhin: Vertauschen Sie die letzten beiden (die Beschriftung, dann das Symbol) — eine Schaltfläche, deren Beschriftung ein Dateipfad ist, zeigt Ihnen die übrigen. Ersetzen Sie jedes is_shortcut aus einem Buchstaben durch ein „&“ in der Beschriftung und verdoppeln Sie jedes „&“, das angezeigt werden soll (R&&D).

12.8 crosstab: das Format der Werte über is_format #

Die Kreuztabelle schrieb die Zahlen einer Kennzahl über eine Funktion mit vier oder fünf Argumenten (Dezimalstellen, Tausendertrennzeichen, Symbol, Symbol davor), die für alle Werte eines Feldes galt: Dasselbe Feld zweimal in Werte — der Betrag und sein Anteil an der Summe — konnte keine zwei Formate haben. 5.0 stellt es unter die Sprache der Diagramme und Anzeigen: ein PowerBuilder-Anzeigeformat in is_format, auf dem Handle des Feldes (of_field) für alle seine Werte oder auf dem Handle eines Wertes (of_value(position), neu) nur für ihn. Leer übernimmt ein Wert das Format der DataWindow-Spalte. Kein alter Name bleibt.

• Das Tausendertrennzeichen eines Wertes ohne Format bleibt is_thousands, wie das Menü Optionen des Rasters: Das tat ein of_set_value_format mit leerem Trennzeichen. Die Währung, die das Chip-Menü anbietet, bleibt is_currency_symbol.
• Ein Wert ohne Format zeigt jetzt das Format seiner Spalte im DataWindow, von of_from_datastore gelesen: Ein Betrag, dessen Spalte #,##0.00 trägt, wird ohne eine Zeile Code mit zwei Dezimalstellen angezeigt.

// 4.0 : decimals, thousands, symbol and its side as arguments - for every value of the field
uo_cross.of_set_value_format(/*field*/ "amount", /*decimals*/ 2, /*thousands*/ "locale", /*suffix*/ "$", /*symbol_before*/ true)

// 5.0 : a display format, written as in a DataWindow - for the field, then for its second value alone
uo_cross.of_field(/*field*/ "amount").is_format = "$#,##0.00"
uo_cross.of_value(/*position*/ 2).is_format = "#,##0"

Das Rezept: Kompilieren Sie; jedes of_set_value_format und of_clear_value_format wird gemeldet. Schreiben Sie das Format wie in einem DataWindow: ai_decimals gibt die Zahl der 0 nach dem Punkt, ein Tausendertrennzeichen das Gruppierungs-, ("none": keines), das Symbol steht davor oder dahinter (in Anführungszeichen, wenn es Ziffern oder Leerzeichen enthält). Das Format eines einzelnen Wertes gehört in of_value(<Position>).is_format.

12.9 listbar: der Rechtsklick trägt seinen Punkt, eine Anordnung wird gemeldet #

Die Seitenleiste schließt sich der Bibliothek in drei Punkten an: Der Rechtsklick auf einen Eintrag liefert seinen Bildschirmpunkt wie bei den Bäumen, den Rastern und dem Kanban; ein Befehl des Codes, der die Anordnung ändert, meldet sie wie eine Geste; ein ausgegrauter Eintrag wird nicht mehr zur Auswahl. Sie erhält außerdem ein Ereignis für den Klick auf den bereits ausgewählten Eintrag, eine Suche und den Aufbau aus einem DataStore (12.6).

// 4.0 : PointerX() of the userobject - the menu opened too high under a ribbon
m_entry.PopMenu(PointerX(), PointerY())

// 5.0 : the pointer of the WINDOW for a PowerBuilder menu (al_x, al_y serve a menu of the library)
m_entry.PopMenu(parent.PointerX(), parent.PointerY())

Das Rezept: Nichts verweigert die Kompilierung — ein Skript von ue_item_rclicked behält as_keys. Öffnen Sie Ihr Menü am Mauszeiger des Fensters (parent.PointerX()), oder übergeben Sie al_x, al_y an of_show eines contextmenu. Setzen Sie die anfängliche Auswahl, bevor Sie ib_veto_selection einschalten, und prüfen Sie, dass Ihr ue_layout_changed den Aufruf verträgt, den of_set_layout jetzt auslöst.

12.10 scheduler: die Art einer Änderung und die bisherigen Werte #

Der Kalender schließt sich dem Gantt-Diagramm an: Die Frage vor einer Geste sagt, ob es ein Verschieben oder eine Größenänderung ist, und die folgenden Ereignisse liefern die bisherigen Werte — ein Protokoll, ein Rückgängigmachen oder eine Bestätigung müssen keine eigene Kopie jedes Termins mehr führen. Eine Auswahl, die Ihr Code entfernt, wird gemeldet, und vier Aufrufe lehnen jetzt ab, was sie stillschweigend annahmen.

// 5.0 : ue_appointment_changing event of uo_sched : (string as_key, string as_kind, string as_start, string as_end, string as_resource) returns boolean
// A resize keeps the day : only a move is checked
if as_kind = u_pbt_scheduler.CHANGE_RESIZE then return true

// Nothing on a Saturday or a Sunday : returning false puts the appointment back
if DayNumber(Date(Left(as_start, 10))) = 1 or DayNumber(Date(Left(as_start, 10))) = 7 then return false
return true

Das Rezept: Nichts verweigert die Kompilierung — ein Skript von ue_appointment_changing, ue_appointment_moved oder ue_appointment_resized behält seine Argumente, die neuen kommen hinzu. Wenn Ihr ue_selection_changed Schaltflächen aktiviert, erhält es jetzt "", wenn der ausgewählte Termin verschwindet; prüfen Sie die Rückgabewerte von of_add_appointment, of_scroll_to_time, of_set_field und of_show_appointment, die jetzt -5 liefern können. Um die Gesten ohne Code zu speichern, siehe ib_write_back.

12.11 shellexplorer: der Fehler nennt seinen Grund #

Der Shell-Explorer gibt jetzt in ue_error wie in ue_path_not_found einen Grund, den Ihr Code prüfen kann — eine REASON_*-Konstante von u_pbt_shellexplorer, gleich in jeder Sprache von Windows. Er löst ue_selected für den bereits gewählten Ordner nicht mehr aus und meldet mit ue_collapsed einen Zweig, den er selbst schließt. Er erhält außerdem den Rechtsklick auf einen Ordner (ue_node_rclicked) und die Adresse der Wurzel.

// 5.0 : ue_error event of uo_tree : (string as_path, string as_reason, string as_message)
// Test the reason, never the text of the shell
if as_reason = u_pbt_shellexplorer.REASON_TIMEOUT then
    st_status.text = "The network folder " + as_path + " does not answer"
else
    st_status.text = as_message
end if

Das Rezept: Nichts verweigert die Kompilierung — ein Skript von ue_error behält as_message, die neuen Argumente kommen hinzu. Eine Prüfung auf den TEXT von as_reason in ue_path_not_found ("not found", "outside the root") wird mit einer REASON_*-Konstante neu geschrieben; eine Anwendung, die bei jedem ue_selected einen Bereich neu lud, tut es jetzt einmal je Änderung.

12.12 tilesbox: der Rechtsklick trägt seinen Punkt, ein Befehl des Codes wird gemeldet, die Anordnung überlässt die Rechte der Anwendung #

Das Kachel-Panel schließt sich der Bibliothek an: sein Rechtsklick liefert den Bildschirmpunkt wie bei den Bäumen, den Rastern und dem Kanban; ein Befehl des Codes, der eine Kachel verschiebt, eine Gruppe einklappt oder eine Größe ändert, löst dieselben Ereignisse aus wie eine Geste; die Anordnung enthält die Sichtbarkeit nicht mehr, sie bleibt Sache der Anwendung. Es erhält außerdem das Verschieben einer Kachel in eine andere Gruppe per Code (12.6).

// 4.0 : the right click of a tile
// ue_tile_context event of uo_tiles : (string as_keys)

// 5.0 : the same script, under the new name, with the screen point
// ue_tile_rclicked event of uo_tiles : (string as_keys, long al_x, long al_y)

Das Rezept: Kompilieren Sie; Ihr Skript von ue_tile_context bleibt an einem Ereignis, das es nicht mehr gibt — verschieben Sie es nach ue_tile_rclicked, das as_keys behält. Wenn Ihr ue_layout_changed die Anordnung speichert, sieht es jetzt auch, was Ihr Code ändert; ein ue_tile_moved, das nur auf den Benutzer reagieren soll, ignoriert die Verschiebungen, die Ihr Code gerade vorgenommen hat. Wenn Sie die Sichtbarkeit in der Anordnung aufbewahrt haben, setzen Sie sie beim Öffnen per Code (ib_visible), nach den Rechten.

12.13 tab: der Rechtsklick trägt seinen Punkt, eine angewendete Anordnung wird gemeldet #

Die Registerkarte schließt sich der Bibliothek an: Der Rechtsklick auf eine Registerkarte liefert bei ausgeschaltetem integriertem Menü seinen Bildschirmpunkt wie bei den Bäumen, den Rastern und dem Kanban, und of_set_layout, das die Anordnung ändert, meldet sie wie eine Geste. Ein an seinen Platz zurückgegebenes Ziehen meldet nichts mehr. Sie erhält außerdem bei Bedarf erzeugte Seiten (ue_page_needed, of_supply_page), den Doppelklick (ue_tab_double_clicked), ib_cycle_keys, is_close_mode, ii_strip_width und, auf einer Seite, ib_modified und is_badge — siehe die Seite der Registerkarte.

// 4.0 : the right click of a tab, built-in menu off
// ue_tab_rclicked event of uo_tabs : (string as_key)

// 5.0 : the same script, with the screen point
// ue_tab_rclicked event of uo_tabs : (string as_key, long al_x, long al_y)

Das Rezept: Nichts verweigert die Kompilierung — ein Skript von ue_tab_rclicked behält as_key. Öffnen Sie Ihr Menü am Mauszeiger des Fensters (parent.PointerX()), oder übergeben Sie al_x, al_y an of_show eines contextmenu. Prüfen Sie, dass Ihr ue_layout_changed den Aufruf verträgt, den of_set_layout jetzt auslöst.

12.14 soundplayer: die Nummer eines Tons, eine sofort zurückgegebene Ablehnung #

Der Soundplayer ändert drei Dinge, die Ihr Code sehen kann. Seine Ereignisse tragen die Nummer des Tons: ue_started, ue_ended und ue_failed erhalten ein letztes Argument, al_sound — die Nummer, die of_play_over und of_enqueue jetzt liefern (sie lieferten 0) und die das neue of_stop_sound nimmt. Eine sofort abgelehnte Quelle ist ein Code: of_play, of_play_over, of_crossfade und of_preload liefern -5, den Grund in of_get_last_error(), für eine leere Quelle, eine http://-Adresse, eine fehlerhafte file://-Adresse oder ein über seinen Namen abgelehntes Format — und lösen kein ue_failed mehr aus; der laufende Ton spielt weiter. In der Warteschlange (of_enqueue) kommt die Ablehnung weiterhin über ue_failed, bei ihrer Runde. Weitere -5: of_pause und of_resume ohne etwas anzuhalten oder fortzusetzen, of_beep und of_beep_sync mit 0 Hz oder 0 ms, of_meter außerhalb von 1 bis 64 Balken.

// Local variables
string ls_url
long ll_rc

// The address of the sound, typed by the user
ls_url = sle_url.text

// 4.0 : of_play returned 0, and an http:// address came back later through ue_failed
// 5.0 : the refusal is a code, at once ; of_get_last_error() gives the reason
ll_rc = inv_sound.of_play(/*source*/ ls_url)
if ll_rc = -5 then
	MessageBox("Sound", inv_sound.of_get_last_error())
end if

Was sich ändert, ohne Ihrem Code etwas abzuverlangen: of_stop klingt jetzt über il_fade_ms aus, wie die Dokumentation es versprach (ue_stopped kommt weiterhin sofort); wenn il_timeout_ms abläuft, wird nur der Ton des synchronen Aufrufs abgebrochen — der Hintergrund, die Überlagerungen und die Warteschlange laufen weiter; of_crossfade zu einer abgelehnten Quelle behält den laufenden Titel; of_level ist 0 und of_spectrum liefert keinen Balken, wenn der Meter aus ist; of_equalizer(ab_on, ai_gains[]) setzt ein Band, das das Array nicht erreicht, auf 0 zurück; of_clear_queue vergisst auch die Töne, die die Warteschlange schon gespielt hat; die Meldungen von ue_failed folgen der Anzeigesprache (as_reason bleibt das zu prüfende Wort). Der Player erhält außerdem die bewegliche Warteschlange (of_next, of_previous, of_queue_index, ue_source_changed, ib_queue_repeat), die lückenlose Schleife (ib_gapless_loop, REASON_TOO_LONG), den Abschnitt (of_play_range), die Stummschaltung (ib_muted) und die Pufferung (ue_buffering, of_is_buffering) — siehe die Seite des Soundplayers.

Das Rezept: Nichts verweigert die Kompilierung — ein Skript von ue_started, ue_ended oder ue_failed behält seine Argumente, al_sound kommt hinzu. Prüfen Sie die Rückgabewert-Tests von of_play_over und of_enqueue (aus = 0 wird > 0) und den Code, der für eine http://-Adresse oder eine leere Quelle auf ue_failed wartete: er prüft jetzt das -5 des Aufrufs.

12.15 toaster: der Grund eines Schließens, ein vom Code geschlossener Toast meldet sich immer #

Der Toaster sagt, warum ein Toast geschlossen wurde: ue_toast_dismissed erhält ein letztes Argument, as_reason — REASON_TIMEOUT, REASON_USER (sein Kreuz), REASON_CODE (of_close, of_close_all) oder REASON_OWNER_CLOSED (sein Fenster wurde geschlossen). Und jeder vom Code geschlossene Toast meldet es, auch direkt nach of_show, bevor er gezeichnet wurde, oder während er auf seinen Platz wartete: Eine Anwendung, die auf ue_toast_dismissed wartete, um ihren Zustand freizugeben, hängt nicht mehr von einem Wettlauf ab.

// 4.0
// Event ue_toast_dismissed von inv_toaster : (long al_id, string as_key)

// 5.0 : dasselbe Skript, mit dem Grund
// Event ue_toast_dismissed von inv_toaster : (long al_id, string as_key, string as_reason)

Das Rezept: Nichts verweigert die Kompilierung — ein Skript von ue_toast_dismissed behält al_id und as_key, as_reason kommt hinzu. Prüfen Sie den Code, der annahm, ein sofort durch of_close geschlossener Toast würde nichts sagen: Er meldet es jetzt. Toasts bleiben an den Toaster gebunden, der sie gezeigt hat: Ein of_close auf die Kennung eines anderen Toasters liefert -5. Der Toaster erhält außerdem of_close_all (alle seine Toasts schließen) und of_get_last_error — siehe die Seite des Toasters.

12.16 video: eine sofort zurückgegebene Ablehnung, ein Film und seine Untertitel in einem Aufruf, derselbe Film fortgesetzt #

Der Videoplayer ändert fünf Dinge, die Ihr Code sehen kann. Eine Ablehnung wird sofort zurückgegeben, wie beim Soundplayer (12.14): of_play(), of_play(source) und of_play_range geben -5 zurück, den Grund in of_get_last_error(), für eine leere Quelle, eine http://-Adresse oder ein an seinem Namen abgelehntes Format (avi, wmv, flv) — und lösen kein ue_failed mehr aus; der laufende Film geht weiter. Die Eigenschaft is_source behält ihr ue_failed: eine Eigenschaft hat keinen Rückgabecode. Derselbe Film wird nicht neu geladen: of_play(source) oder is_source auf dem bereits geladenen Film setzt ihn fort, wo er ist (ue_resumed), statt ihn neu zu starten; of_seek(0) startet ihn neu. Eine Suche bleibt im Abschnitt von of_play_range, die des Benutzers wie of_seek: Pos1 geht zum Anfang des Abschnitts, ein Klick hinter sein Ende zu seinem Ende — vorher verließ Pos1 den Ausschnitt, und ein Klick dahinter hielt den Film an. Ein nicht abspielbarer Listeneintrag löst zuerst ue_source_changed aus, dann ein einziges ue_failed — es kam vorher, und zweimal. of_stop wird eine Funktion: es gab nichts zurück (Subroutine), es gibt 0 zurück, oder -2, wenn die Komponente nicht erzeugt ist — wie of_stop des Webbrowsers.

// Local variables
string ls_path
long ll_rc

// The film chosen by the user
ls_path = sle_film.text

// 4.0 : of_play returned 0, and an http:// address or an .avi came back later through ue_failed
// 5.0 : the refusal is a code, at once ; the reason is in of_get_last_error
ll_rc = uo_video.of_play(/*source*/ ls_path)
if ll_rc = -5 then
	MessageBox("Video", uo_video.of_get_last_error())
end if

Was sich ändert, ohne Ihrem Code etwas abzuverlangen: eine Marke, die durch eine Suche WÄHREND DER PAUSE erreicht wird, löst kein ue_marker_reached mehr aus (nur ue_seeked); Leertaste und Wiedergabe-Schaltfläche eines Players ohne Film tun nichts mehr (sie lösten ue_failed(REASON_NO_SOURCE) aus); die vom Benutzer gewählte Untertitelsprache folgt zum nächsten Film der Liste; ein http://-Poster wird abgelehnt und is_poster liest sich leer; ein abgelehntes is_subtitles liest sich leer; eine nicht auffindbare Untertiteldatei des Arbeitsplatzes löst ue_subtitles_failed(REASON_NOT_FOUND) aus; das Geschwindigkeitsmenü ist per Tastatur bedienbar, und seine Pfeile ändern die Lautstärke nicht mehr; im Vollbild zeigt sich die Leiste über die Tastatur; die gemerkte Position (ib_remember_position) hängt nicht mehr von der Schreibweise des Pfads ab, und nur die letzten 200 Filme werden behalten (eine Position aus 4.0 wird noch einmal gelesen). Der Player erhält of_play(source, subtitles) (der Film und SEINE Untertitel: vor einem zweiten Film gesetzt, gingen sie mit dem ersten), ib_forward_seek, of_watched_ms, of_watched_percent, ue_watched_completely und ib_skip_failed — siehe die Seite des Videoplayers.

Das Rezept: nichts verweigert das Kompilieren. Lesen Sie den Code noch einmal, der nach of_play für eine http://-Adresse, eine leere Quelle oder eine .avi auf ue_failed wartete: er prüft jetzt die -5 des Aufrufs. Lesen Sie auch eine „Abspielen“-Schaltfläche noch einmal, die sich darauf verließ, dass of_play(source) von vorn beginnt: fügen Sie of_seek(0) hinzu.

12.17 webbrowser: eine Geste des Benutzers wird erfragt, eine Seite von of_show_html hat keine Adresse #

Mit ib_veto_navigation = true wird ue_navigating jetzt auch für eine Geste des Benutzers erfragt: eine in die Leiste getippte Adresse, Link öffnen im Kontextmenü, ein durch einen Klick geöffnetes neues Fenster. In 4.0 fragten diese drei Wege nicht. Nur eine von Ihrem Code gesetzte Adresse wird nie erfragt, ebenso wenig eine Umleitung des Servers: Für eine Serverliste, die auch für Umleitungen gilt, setzen Sie die neue Eigenschaft is_allowed_hosts.

Das Rezept: nichts verweigert das Kompilieren, ein ignorierter long kompiliert. Ein für die Links der Website geschriebenes Skript von ue_navigating sieht jetzt auch die vom Benutzer getippten Adressen: Wenn es anhand der Adresse entscheidet, soll es deren Host vergleichen, wie das Beispiel der Komponentenseite — oder überlassen Sie die Liste is_allowed_hosts. Code, der as_url von ue_load_completed oder is_address nach of_show_html las, erhält eine leere Zeichenkette.

12.18 toolbar: der Rechtsklick trägt seinen Punkt, ein Befehl des Codes wird gemeldet #

Die Symbolleiste schließt sich der Bibliothek an: der Rechtsklick eines Werkzeugs liefert seinen Bildschirmpunkt, wie bei den Bäumen, den Rastern und der Registerkarte, und das Verschieben einer Leiste per ii_band / ii_index löst ue_bar_reordered wie die Geste aus. Zwei Hinzufügungen lehnen ab, was sie stillschweigend annahmen, und ein Tastenkürzel, das dort gesetzt wird, wo nichts lebt, wird nicht mehr registriert. Sie erhält außerdem is_text auf einer Leiste, einen von einem Bildschirmleser gelesenen Namen für jedes Werkzeug und jedes Feld sowie eine Tastatur, die die Felder durchquert — siehe die Seite der Symbolleiste.

// 4.0 : the right click of a tool
// ue_item_rclicked event of uo_toolbar : (string as_keys)

// 5.0 : the same script, with the screen point
// ue_item_rclicked event of uo_toolbar : (string as_keys, long al_x, long al_y)

Das Rezept: nichts verweigert die Kompilierung — ein Skript von ue_item_rclicked behält as_keys. Öffnen Sie Ihr Menü am Punkt al_x, al_y (übergeben Sie ihn an of_show eines contextmenu). Prüfen Sie, dass ein Skript von ue_bar_reordered auch die Verschiebungen Ihres Codes annimmt, testen Sie den Rückgabecode von of_add_datepicker, wenn das Datum aus einem regionalen Feld kommt, und setzen Sie is_shortcut nach dem Hinzufügen des Werkzeugs oder des Eintrags.

12.19 Der Rechtsklick auf ein Element trägt seinen Punkt: buttonbar, breadcrumb, chartcartesian, statusbar #

Eine einzige Regel für jeden Rechtsklick auf ein Element der Bibliothek: das Ereignis erhält den Schlüssel (oder die Adresse) des Elements, dann al_x, al_y, den Punkt, an dem ein Menü zu öffnen ist, in Bildschirmpixeln — der Zeiger, oder über die Tastatur (Menü-Taste, Umschalt+F10) die Ecke unten links des Elements (unten rechts bei Leserichtung von rechts nach links; die Mitte einer Form, die kein Rechteck ist: ein Punkt eines Diagramms). Ein contextmenu der Bibliothek öffnet sich dort unverändert: uo_menu.of_show(al_x, al_y). Drei Ereignisse, die ihn nicht trugen, erhalten ihn; die Statusleiste multiplizierte ihren mit der Skalierung des Bildschirms, und ein dort geöffnetes Menü landete auf einem Bildschirm mit 125 % oder 150 % weit vom Zeiger entfernt.

// 5.0 : the menu of a button, opened where the user right-clicked it
// ue_button_rclicked event of uo_buttons : (string as_key, long al_x, long al_y)
is_menu_button = as_key
uo_menu.of_show(/*x*/ al_x, /*y*/ al_y)

Das Rezept: nichts verweigert die Kompilierung — ein Skript dieser Ereignisse behält seine Argumente. Öffnen Sie Ihr Menü am Punkt al_x, al_y (übergeben Sie ihn an of_show eines contextmenu); ein PowerBuilder-Menü behält PopMenu(PointerX(), PointerY()) Ihres Fensters. Ein Skript, das die Skalierung der Koordinaten von ue_panel_rclicked selbst korrigierte, darf das nicht mehr tun.

12.20 Die Basis: der Fehler einer Komponente ist ihr eigener, jedes Verb liefert einen Code #

Fünf Änderungen betreffen die ganze Bibliothek oder eine ganze Familie von Komponenten. Nur eine verweigert die Kompilierung: is_last_error einer nicht visuellen Komponente, jetzt of_get_last_error().

// Local variables
string ls_why

// 4.0 : ls_why = inv_crypto.is_last_error
// 5.0 : the reason of a failure, by the same method as every component
ls_why = inv_crypto.of_get_last_error()

Das Rezept: Der Compiler zeigt jedes .is_last_error, das durch .of_get_last_error() zu ersetzen ist. Ein als Anweisung geschriebener Aufruf von of_stop, of_close oder of_reset kompiliert weiterhin. Ein Skript, das of_get_last_error() einer Komponente las, um das Scheitern eines anderen Aufrufs zu erfahren (ein direkt aufgerufener Export der DLL, eine andere Komponente), liest jetzt den Grund dieser Komponente oder nichts: Fragen Sie den, der gescheitert ist.

Hinzugefügt, nichts nachzuarbeiten: is_accessible_name und is_accessible_description auf allen visuellen Komponenten — Name und Beschreibung, die ein Bildschirmleser sagt (3.4); of_from_datastore eines DataWindow oder eines DataWindowChild bei crosstab und datagrid, wie bei den anderen datengebundenen Komponenten; die vollständige Form von of_insert_command (commandpalette), die Hinweis, Kürzel und Schlüsselwörter wie of_add_command nimmt, mit einer Position als long.

← Von 3.0 auf 4.0 migrieren · Inhalt · Versionshinweise →