12. Migrer de la 4.0 à la 5.0 #

← Migrer de la 3.0 à la 4.0 · Sommaire · Notes de version →

La 5.0 ne change aucune signature des trente-sept composants de la 4.0, ni aucun événement — sauf la barre de boutons (buttonbar, 12.7) et l'événement ue_link_clicked du visualiseur Markdown (markdownview), qui reçoit un second argument, as_kind (12.5). Trois composants changent de mots. La barre de progression (progressbar) prend ceux des jauges — ib_label, il_color et is_label_format disparaissent au profit de ib_show_value, il_value_color, is_format et is_unit (12.1). Le graphique cartésien (chartcartesian) écrit ses nombres par is_format, comme les jauges et le camembert : of_set_value_format et of_clear_value_format disparaissent, et ii_point_count d’une série devient il_point_count (12.4). Le croisé (crosstab) suit le même chemin : of_set_value_format et of_clear_value_format disparaissent au profit de is_format — sur le champ, ou sur une seule valeur par of_value — et de ib_negative_red (12.8). Le compilateur vous montre chaque ligne à reprendre. La barre latérale (listbar) change un événement : ue_item_rclicked reçoit en plus le point d'écran du clic, al_x et al_y (12.9). Le panneau de tuiles (tilesbox) renomme un événement : ue_tile_context(as_keys) devient ue_tile_rclicked(as_keys, al_x, al_y), et la position d'of_move_tile et d'of_insert_tile passe en long al_position (12.12). Le menu radial (radialmenu) perd quatre propriétés d'infobulle qu'il n'a jamais montrées — is_tooltip, is_super_tooltip_title, is_super_tooltip_text et is_super_tooltip_image (12.5). Le calendrier (scheduler) change trois événements de geste : ue_appointment_changing reçoit as_kind, ue_appointment_moved et ue_appointment_resized reçoivent les valeurs d'avant (12.10). L'explorateur du shell (shellexplorer) change un événement : ue_error reçoit en plus le chemin et une raison constante, as_path et as_reason (12.11). Le bloc de texte riche (statictext) change un événement : ue_hyperlink reçoit en plus ab_opened, si le lien s'est vraiment ouvert (12.5). L'onglet (tab) change un événement : ue_tab_rclicked reçoit en plus le point d'écran du clic, al_x et al_y (12.13). Le lecteur de sons (soundplayer) change trois événements : ue_started, ue_ended et ue_failed reçoivent en plus le numéro du son, al_sound (12.14). Le toaster (toaster) change un événement : ue_toast_dismissed reçoit en plus la raison de la fermeture, as_reason (12.15). Le navigateur web (webbrowser) : of_go_back, of_go_forward et of_stop rendent un long, et sous ib_veto_navigation une adresse tapée par l'utilisateur est demandée à ue_navigating (12.17). La barre d'outils (toolbar) change un événement : ue_item_rclicked reçoit en plus le point d'écran du clic, al_x et al_y (12.18). Le lecteur vidéo (video) change une signature : of_stop devient une fonction qui rend un long (12.16) — un appel écrit comme une instruction compile toujours. Trois composants changent un événement de clic droit d'item, qui reçoit en plus son point d'écran al_x, al_y : la barre de boutons (ue_button_rclicked), le fil d'Ariane (breadcrumb, ue_item_rclicked) et le graphique cartésien (ue_point_rclicked) ; la barre d'état (statusbar) donne ce point comme les autres, sans plus le multiplier par l'échelle de l'écran (12.19). Le socle (12.20) : la raison d'un échec d'un composant non visuel se lit par of_get_last_error() — la propriété is_last_error disparaît de crypto, restclient, soundplayer, speechout, xml, u_pbt_regex et u_pbt_zip —, et of_stop, of_close et of_reset des non visuels rendent un long.

Le reste ne demande rien à votre code : la grille de données (datagrid) et le ruban (ribbon) gagnent des masques de saisie numériques, et l'éditeur d'une colonne numérique de la grille s'ouvre désormais sur le texte du masque (12.2, 12.3). Les nouveaux composants de la 5.0 sont présentés dans les notes de version.

12.1 progressbar : les mots des jauges #

La 5.0 apporte deux jauges, linéaire (gauge) et à cadran (angulargauge). Une barre de progression montre elle aussi une valeur sur une échelle : la bibliothèque ne parle plus qu'une langue pour cela, et la barre, qui disait autrement la même chose, prend les mots des jauges. Aucun ancien nom ne survit : ni propriété, ni nom accepté par of_set_property.

• is_format est un format d'affichage PowerBuilder appliqué à la valeur ("#,##0", "$#,##0.00"), avec les séparateurs de la langue d'affichage, exactement comme pour les jauges. Vide, la barre montre le pourcentage, comme avant.
• Les jetons {percent}, {value}, {min} et {max} n'existent plus. Un libellé qui mêlait valeur et pourcentage ("{value} of {max} rows ({percent})") n'a pas d'équivalent exact : choisissez la valeur (format et unité) ou le pourcentage (et une unité). Le maximum, que votre code connaît, s'écrit dans l'unité.
• is_unit est nouveau : un texte brut écrit après la lecture, séparé d'une espace — après la valeur comme après le pourcentage. of_reset le vide.
• Un masque qui contient % écrit la part accomplie, pas la valeur : is_format = "0.0%" donne « 35.0% » pour 1 687 lignes sur 4 820, arrondi vers le bas comme le pourcentage — le pourcentage à décimales que {percent} ne savait pas écrire.
• Une attente en pause ou en erreur devient une barre pleine. En 4.0, une barre en attente (ib_indeterminate) qui recevait STATE_PAUSED ou STATE_ERROR se figeait dans son glissement, souvent hors de sa piste : l'échec ne se voyait pas. En 5.0 elle s'arrête en barre (en anneau) pleine à la couleur de l'état, comme la barre des tâches de Windows, et le lecteur d'écran ne l'annonce plus « occupée » mais dit son état.
• of_set_property("tooltip", …) et super_tooltip_* rendent -5 : la barre ne publie pas d'info-bulle, et la porte par nom, qui en posait une, est fermée comme les propriétés.
• Nouveau, sans rien à reprendre : is_orientation (ORIENTATION_VERTICAL : une barre debout, à la place d'un VProgressBar), is_accessible_name (le nom que dit le lecteur d'écran), et le texte d'une attente (is_unit seul quand la barre est en attente).

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

La recette : compilez ; chaque ib_label, il_color et is_label_format d'une barre de progression est signalé. Remplacez les deux premiers par ib_show_value et il_value_color. Pour le troisième : un texte vide reste vide dans is_format ; un libellé qui écrivait la valeur devient un format ("#,##0") et une unité ; un libellé qui écrivait le pourcentage garde is_format vide et met son texte dans is_unit. Un of_set_property qui nommait label, label_format ou color rend désormais -5 et ne fait rien (of_get_last_error nomme la propriété) : cherchez ces noms dans votre code.

12.2 datagrid : un éditeur numérique qui tape au masque #

Aucune signature ne change, et ue_cell_edited reçoit toujours le nombre nu (1234.5). Ce qui change se voit à l'écran : la saisie d'une colonne numérique suit désormais un masque de saisie, dans la syntaxe du DataWindow — celui que vous donnez par la nouvelle propriété is_mask de la colonne, sinon son format d'affichage dépouillé de ses littéraux.

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

La recette : rien à changer. Un code qui lisait le texte tapé ne le voit pas : ue_cell_edited rend toujours le nombre. Une colonne dont la saisie doit rester libre (un code, un numéro de pièce) est une colonne texte, pas numérique.

12.3 ribbon : les masques d'un compteur #

Rien ne change pour un compteur qui n'a pas de masque. Deux propriétés nouvelles de sa poignée, dans la syntaxe de PowerBuilder : is_mask, le masque de saisie ("#,##0.00", "0%"), et is_format, le format d'affichage avec ses littéraux (0 "pt" montre 11 pt, qui se tape 11). id_value et ue_value_changed gardent le nombre nu, la bascule entre les deux ne lève aucun événement, et les masques suivent le compteur dans le panneau d'un groupe replié.

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

La recette : rien à changer.

12.4 chartcartesian : le format des nombres par is_format #

Le graphique cartésien écrivait ses nombres par une fonction à quatre arguments (décimales, préfixe, suffixe, séparateur de milliers). La 5.0 range les graphiques et les jauges sous une seule langue : un format d'affichage PowerBuilder, celui d'une colonne de DataWindow, dans la propriété is_format — du graphique entier, et d'un axe par sa poignée. Les sections positif;négatif;zéro, les littéraux et le pourcentage viennent avec, et les séparateurs restent ceux de la langue d'affichage. Aucun ancien nom ne survit.

• Le format d'un axe passe devant celui du graphique, et le reste. Poser le format du graphique n'efface plus celui des axes (la forme sans axe de of_set_value_format le faisait) : un axe revient au format du graphique par is_format = "".
• Sans format (vide, ou un format qui n'est pas numérique), le nombre s'écrit tel quel, au millième, avec la virgule ou le point de la langue d'affichage — comme le faisait le format par défaut.

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

La recette : compilez ; chaque of_set_value_format et of_clear_value_format est signalé. Écrivez le format comme dans une DataWindow : decimals donne le nombre de 0 après le point (-1 = #,##0.###), thousands le , du groupement, le préfixe et le suffixe s'écrivent devant et derrière (entre guillemets s'ils contiennent des chiffres ou des espaces). Le format d'un axe va dans of_axis(<axe>).is_format.

12.5 Autres comportements que vous pouvez voir #

La recette : rien à changer.

12.6 Ce qui a été ajouté #

Rien de ce qui suit ne demande de modifier votre code. Les huit nouveaux composants de la 5.0 sont présentés dans les notes de version.

12.7 buttonbar : la clé, le libellé puis l'icône ; le « & » et l'accord #

La barre de boutons parlait autrement que le reste de la bibliothèque : l'icône avant le libellé, la position en deuxième argument, et un is_shortcut qui voulait dire « lettre Alt » là où il veut dire « accord » partout ailleurs — is_shortcut = "Ctrl+S" armait Alt+C. La 5.0 l'aligne sur button, la barre d'outils et le CommandButton de PowerBuilder.

• is_shortcut d'un bouton est un accord. Pendant la 5.0, une lettre seule y est encore lue comme la lettre Alt de la 4.0 (elle passe dans is_mnemonic) ; écrivez plutôt le « & » dans le libellé. Un accord que la fenêtre ne peut jamais lever (une lettre seule, Ctrl+Shift) est refusé : is_shortcut se relit vide, of_register_shortcut rend -5.
• Un bouton grisé ne vole plus de touche. Le bouton par défaut grisé d'une barre, ou la lettre Alt d'un bouton grisé, laisse Entrée et la lettre à la fenêtre — elles ne partent plus au bouton d'une AUTRE barre (deux feuilles MDI) ; l'accord d'un bouton grisé laisse sa touche à la fenêtre (un accélérateur de menu, par exemple). Les flèches sautent un bouton grisé.

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

La recette : compilez ; un appel d'of_insert_button est signalé (la position passe en dernier). Un of_add_button à trois arguments compile toujours : échangez les deux derniers (le libellé, puis l'icône) — un bouton dont le libellé est un chemin de fichier vous montre ceux qui restent. Remplacez chaque is_shortcut d'une lettre par un « & » dans le libellé, et doublez tout « & » qui doit s'afficher (R&&D).

12.8 crosstab : le format des valeurs par is_format #

Le croisé écrivait les nombres d'une mesure par une fonction à quatre ou cinq arguments (décimales, séparateur de milliers, symbole, symbole devant), qui valait pour toutes les valeurs d'un champ : le même champ deux fois en Valeurs — le montant, et sa part du total — ne pouvait pas avoir deux formats. La 5.0 le range sous la langue des graphiques et des jauges : un format d'affichage PowerBuilder dans is_format, sur la poignée du champ (of_field) pour toutes ses valeurs, ou sur la poignée d'une valeur (of_value(position), nouvelle) pour elle seule. Vide, une valeur prend le Format de la colonne du DataWindow. Aucun ancien nom ne survit.

• Le séparateur de milliers d'une valeur sans format reste is_thousands, comme le menu Options de la grille : c'est ce que faisait un of_set_value_format au séparateur vide. La devise que propose le menu de la puce reste is_currency_symbol.
• Une valeur sans format montre désormais le Format de sa colonne du DataWindow, lu par of_from_datastore : un montant dont la colonne porte #,##0.00 s'affiche avec deux décimales sans une ligne de code.

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

La recette : compilez ; chaque of_set_value_format et of_clear_value_format est signalé. Écrivez le format comme dans une DataWindow : ai_decimals donne le nombre de 0 après le point, un séparateur de milliers donne le , du groupement ("none" : aucun), le symbole s'écrit devant ou derrière (entre guillemets s'il contient des chiffres ou des espaces). Le format d'une seule valeur va dans of_value(<position>).is_format.

12.9 listbar : le clic droit porte son point, une disposition s'annonce #

La barre latérale rejoint la bibliothèque sur trois points : le clic droit d'une entrée donne son point d'écran comme celui des arbres, des grilles et du kanban ; un ordre du code qui change la disposition l'annonce comme un geste ; une entrée grisée ne devient plus la sélection. Elle gagne aussi un événement pour le clic sur l'entrée déjà sélectionnée, une recherche et la construction depuis un 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())

La recette : rien ne refuse de compiler — un script de ue_item_rclicked garde as_keys. Ouvrez votre menu au pointeur de la fenêtre (parent.PointerX()), ou passez al_x, al_y à of_show d'un contextmenu. Posez la sélection initiale avant d'armer ib_veto_selection, et vérifiez que votre ue_layout_changed accepte l'appel que lève désormais of_set_layout.

12.10 scheduler : la nature d'un changement et les valeurs d'avant #

Le calendrier rejoint le diagramme de Gantt : la question posée avant un geste dit s'il s'agit d'un déplacement ou d'un redimensionnement, et les événements qui suivent donnent les valeurs d'avant — un journal, une annulation ou une confirmation n'ont plus à garder leur copie de chaque rendez-vous. Une sélection que votre code retire est annoncée, et quatre appels refusent désormais ce qu'ils acceptaient en silence.

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

La recette : rien ne refuse de compiler — un script de ue_appointment_changing, ue_appointment_moved ou ue_appointment_resized garde ses arguments, les nouveaux s'y ajoutent. Si votre ue_selection_changed active des boutons, il reçoit maintenant "" quand le rendez-vous sélectionné part ; relisez les codes retour d'of_add_appointment, of_scroll_to_time, of_set_field et of_show_appointment, qui peuvent désormais rendre -5. Pour enregistrer les gestes sans code, voyez ib_write_back.

12.11 shellexplorer : l'erreur dit sa raison #

L'explorateur du shell donne désormais, dans ue_error comme dans ue_path_not_found, une raison que votre code peut tester — une constante REASON_* de u_pbt_shellexplorer, la même dans toutes les langues de Windows. Il ne lève plus ue_selected pour le dossier déjà sélectionné, et annonce par ue_collapsed une branche qu'il referme de lui-même. Il gagne aussi le clic droit sur un dossier (ue_node_rclicked) et l'adresse de la racine.

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

La recette : rien ne refuse de compiler — un script de ue_error garde as_message, les nouveaux arguments s'y ajoutent. Un test sur le TEXTE de as_reason dans ue_path_not_found ("not found", "outside the root") se réécrit avec une constante REASON_* ; une application qui rechargeait un volet à chaque ue_selected le fait désormais une fois par changement.

12.12 tilesbox : le clic droit porte son point, un ordre du code s'annonce, la disposition laisse les droits à l'application #

Le panneau de tuiles rejoint la bibliothèque : son clic droit donne le point d'écran comme celui des arbres, des grilles et du kanban ; un ordre du code qui déplace une tuile, replie un groupe ou change une taille lève les mêmes événements qu'un geste ; la disposition ne porte plus la visibilité, qui reste l'affaire de l'application. Il gagne aussi le déplacement d'une tuile vers un autre groupe par le 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)

La recette : compilez ; votre script de ue_tile_context reste sur un événement qui n'existe plus — déplacez-le dans ue_tile_rclicked, qui garde as_keys. Si votre ue_layout_changed enregistre la disposition, il voit désormais aussi ce que votre code change ; un ue_tile_moved qui ne doit réagir qu'à l'utilisateur ignore les déplacements que votre code vient de faire. Si vous rangiez la visibilité dans la disposition, posez-la par le code à l'ouverture (ib_visible), selon les droits.

12.13 tab : le clic droit porte son point, une disposition appliquée s'annonce #

L'onglet rejoint la bibliothèque : le clic droit d'un onglet, menu intégré coupé, donne son point d'écran comme celui des arbres, des grilles et du kanban, et of_set_layout qui change la disposition l'annonce comme un geste. Un glisser rendu à sa place n'annonce plus rien. Il gagne aussi des pages créées à la demande (ue_page_needed, of_supply_page), le double-clic (ue_tab_double_clicked), ib_cycle_keys, is_close_mode, ii_strip_width et, sur une page, ib_modified et is_badge — voir la page de l'onglet.

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

La recette : rien ne refuse de compiler — un script de ue_tab_rclicked garde as_key. Ouvrez votre menu au pointeur de la fenêtre (parent.PointerX()), ou passez al_x, al_y à of_show d'un contextmenu. Vérifiez que votre ue_layout_changed accepte l'appel que lève désormais of_set_layout.

12.14 soundplayer : le numéro d'un son, un refus rendu tout de suite #

Le lecteur de sons change trois choses que votre code peut voir. Ses événements portent le numéro du son : ue_started, ue_ended et ue_failed reçoivent un dernier argument, al_sound — le numéro que rendent désormais of_play_over et of_enqueue (ils rendaient 0), et que prend le nouveau of_stop_sound. Une source refusée d'emblée est un code : of_play, of_play_over, of_crossfade et of_preload rendent -5, la raison dans of_get_last_error(), pour une source vide, une adresse http://, une adresse file:// mal formée ou un format refusé par son nom — et ne lèvent plus ue_failed ; le son en cours continue. Dans la file (of_enqueue), le refus arrive toujours par ue_failed, à son tour. D'autres -5 : of_pause et of_resume sans rien à suspendre ou reprendre, of_beep et of_beep_sync à 0 Hz ou 0 ms, of_meter hors de 1 à 64 barres.

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

Ce qui change sans rien demander à votre code : of_stop s'éteint désormais sur il_fade_ms, comme la documentation le promettait (ue_stopped arrive toujours tout de suite) ; à l'échéance de il_timeout_ms, seul le son de l'appel synchrone est coupé — le fond, les superpositions et la file continuent ; of_crossfade vers une source refusée garde la piste en cours ; of_level vaut 0 et of_spectrum ne rend aucune barre, vumètre éteint ; of_equalizer(ab_on, ai_gains[]) remet à 0 une bande que le tableau n'atteint pas ; of_clear_queue oublie aussi les sons que la file a déjà joués ; les messages de ue_failed suivent la langue d'affichage (as_reason reste le mot à tester). Le lecteur gagne aussi la file navigable (of_next, of_previous, of_queue_index, ue_source_changed, ib_queue_repeat), la boucle sans blanc (ib_gapless_loop, REASON_TOO_LONG), le segment (of_play_range), le muet (ib_muted) et la mise en mémoire tampon (ue_buffering, of_is_buffering) — voir la page du lecteur de sons.

La recette : rien ne refuse de compiler — un script de ue_started, ue_ended ou ue_failed garde ses arguments, al_sound s'y ajoute. Relisez les tests de code retour d'of_play_over et d'of_enqueue (un = 0 devient > 0), et le code qui attendait ue_failed pour une adresse http:// ou une source vide : il teste maintenant le -5 de l'appel.

12.15 toaster : la raison d'une fermeture, un toast fermé par le code s'annonce toujours #

Le toaster dit pourquoi un toast s'est fermé : ue_toast_dismissed reçoit un dernier argument, as_reason — REASON_TIMEOUT, REASON_USER (sa croix), REASON_CODE (of_close, of_close_all) ou REASON_OWNER_CLOSED (sa fenêtre s'est fermée). Et tout toast fermé par le code l'annonce, même fermé juste après of_show, avant d'être dessiné, ou pendant qu'il attendait sa place : une application qui attendait ue_toast_dismissed pour libérer son état ne dépend plus d'une course.

// 4.0
// event ue_toast_dismissed de inv_toaster : (long al_id, string as_key)

// 5.0 : le meme script, avec la raison
// event ue_toast_dismissed de inv_toaster : (long al_id, string as_key, string as_reason)

La recette : rien ne refuse de compiler — un script de ue_toast_dismissed garde al_id et as_key, as_reason s'y ajoute. Relisez le code qui supposait qu'un toast fermé tout de suite par of_close ne dirait rien : il l'annonce maintenant. Les toasts restent accrochés au toaster qui les a montrés : un of_close sur l'identifiant d'un autre toaster rend -5. Le toaster gagne aussi of_close_all (fermer tous ses toasts) et of_get_last_error — voir la page du toaster.

12.16 video : un refus rendu tout de suite, un film et ses sous-titres d'un seul appel, le même film repris #

Le lecteur vidéo change cinq choses que votre code peut voir. Un refus est rendu tout de suite, comme au lecteur de sons (12.14) : of_play(), of_play(source) et of_play_range rendent -5, la raison dans of_get_last_error(), pour une source vide, une adresse http:// ou un format refusé par son nom (avi, wmv, flv) — et ne lèvent plus ue_failed ; le film en cours continue. La propriété is_source garde son ue_failed : une propriété n'a pas de code retour. Le même film n'est pas rechargé : of_play(source) ou is_source sur le film déjà chargé le reprend où il est (ue_resumed), au lieu de le faire repartir du début ; of_seek(0) le fait repartir. Une recherche reste dans le segment de of_play_range, celle de l'utilisateur comme of_seek : Début mène au début du segment, un clic au-delà de sa fin à sa fin — avant, Début sortait de l'extrait et un clic au-delà arrêtait le film. Une entrée de liste qui ne peut pas jouer lève ue_source_changed d'abord, puis un seul ue_failed — il venait avant, et deux fois. of_stop devient une fonction : il rendait rien (subroutine), il rend 0, ou -2 quand le composant n'est pas créé — comme of_stop du navigateur web.

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

Ce qui change sans rien demander à votre code : un marqueur atteint par une recherche EN PAUSE ne lève plus ue_marker_reached (seulement ue_seeked) ; Espace et le bouton Lecture d'un lecteur sans film ne font plus rien (ils levaient ue_failed(REASON_NO_SOURCE)) ; la langue de sous-titres choisie par l'utilisateur suit au film suivant de la liste ; une affiche http:// est refusée et is_poster se relit vide ; is_subtitles refusé se relit vide ; un sous-titre du poste introuvable lève ue_subtitles_failed(REASON_NOT_FOUND) ; le menu de vitesse se pilote au clavier et ses flèches ne changent plus le volume ; en plein écran la barre se montre au clavier ; la position retenue (ib_remember_position) ne dépend plus de l'écriture du chemin, et seuls les 200 derniers films sont gardés (une position de la 4.0 est relue une fois). Le lecteur gagne of_play(source, subtitles) (le film et SES sous-titres : posés avant un deuxième film, ils partaient avec le premier), ib_forward_seek, of_watched_ms, of_watched_percent, ue_watched_completely et ib_skip_failed — voir la page du lecteur vidéo.

La recette : rien ne refuse de compiler. Relisez le code qui attendait ue_failed après of_play pour une adresse http://, une source vide ou un .avi : il teste désormais le -5 de l'appel. Relisez aussi un bouton « Lire » qui comptait sur of_play(source) pour repartir du début : ajoutez of_seek(0).

12.17 webbrowser : un geste de l'utilisateur est demandé, une page d'of_show_html n'a pas d'adresse #

Avec ib_veto_navigation = true, ue_navigating est désormais demandé aussi pour un geste de l'utilisateur : une adresse tapée dans la barre, Ouvrir le lien du menu contextuel, une nouvelle fenêtre ouverte par un clic. En 4.0, ces trois chemins ne posaient pas la question. Seule une adresse posée par votre code n'est jamais demandée, et une redirection du serveur ne l'est pas non plus : pour une liste de serveurs qui vaut aussi pour les redirections, posez la nouvelle propriété is_allowed_hosts.

La recette : rien ne refuse de compiler, un long ignoré compile. Un script de ue_navigating écrit pour les liens du site voit désormais aussi les adresses tapées par l'utilisateur : s'il décide sur l'adresse, qu'il compare son hôte, comme l'exemple de la page du composant — ou confiez la liste à is_allowed_hosts. Le code qui lisait as_url de ue_load_completed, ou is_address, après of_show_html reçoit une chaîne vide.

12.18 toolbar : le clic droit porte son point, un ordre du code s'annonce #

La barre d'outils rejoint la bibliothèque : le clic droit d'un outil donne son point d'écran, comme celui des arbres, des grilles et de l'onglet, et déplacer une barre par ii_band / ii_index lève ue_bar_reordered comme le geste. Deux ajouts refusent ce qu'ils acceptaient en silence, et un raccourci posé là où rien ne vit n'est plus inscrit. Elle gagne aussi is_text sur une barre, un nom pour chaque outil et chaque champ lu par un lecteur d'écran, et un clavier qui traverse les champs — voir la page de la barre d'outils.

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

La recette : rien ne refuse de compiler — un script de ue_item_rclicked garde as_keys. Ouvrez votre menu au point al_x, al_y (passez-le à of_show d'un contextmenu). Vérifiez qu'un script de ue_bar_reordered accepte aussi les déplacements que fait votre code, testez le code retour d'of_add_datepicker si la date vient d'un champ régional, et posez is_shortcut après l'ajout de l'outil ou de l'entrée.

12.19 Le clic droit d'un item porte son point : buttonbar, breadcrumb, chartcartesian, statusbar #

Une seule règle pour tout clic droit sur un item de la bibliothèque : l'événement reçoit la clé (ou l'adresse) de l'item, puis al_x, al_y, le point où ouvrir un menu, en pixels d'écran — le pointeur, ou, au clavier (touche Menu, Maj+F10), le coin bas-gauche de l'item (bas-droit en lecture de droite à gauche ; le milieu d'une forme qui n'est pas un rectangle : un point de graphique). Un contextmenu de la bibliothèque s'y ouvre tel quel : uo_menu.of_show(al_x, al_y). Trois événements qui ne le portaient pas le reçoivent ; la barre d'état multipliait le sien par l'échelle de l'écran, et un menu ouvert à ce point tombait loin du pointeur sur un écran à 125 % ou 150 %.

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

La recette : rien ne refuse de compiler — un script de ces événements garde ses arguments. Ouvrez votre menu au point al_x, al_y (passez-le à of_show d'un contextmenu) ; un menu PowerBuilder garde PopMenu(PointerX(), PointerY()) de votre fenêtre. Un script qui corrigeait lui-même l'échelle des coordonnées de ue_panel_rclicked ne doit plus le faire.

12.20 Le socle : l'erreur d'un composant est la sienne, chaque verbe rend un code #

Cinq changements touchent toute la bibliothèque, ou toute une famille de composants. Un seul refuse de compiler : is_last_error d'un composant non visuel, devenu 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()

La recette : le compilateur montre chaque .is_last_error à remplacer par .of_get_last_error(). Un appel à of_stop, of_close ou of_reset écrit comme une instruction compile toujours. Un script qui lisait of_get_last_error() d'un composant pour connaître l'échec d'un autre appel (un export de la DLL appelé directement, un autre composant) lit désormais la raison de ce composant-là, ou rien : demandez-la à celui qui a échoué.

Ajouté, sans rien à reprendre : is_accessible_name et is_accessible_description sur tous les composants visuels — le nom et la description que dit un lecteur d'écran (3.4) ; of_from_datastore d'un DataWindow ou d'un DataWindowChild sur crosstab et datagrid, comme sur les autres composants liés à des données ; la forme complète d'of_insert_command (commandpalette), qui prend l'indication, le raccourci et les mots-clés comme of_add_command, avec une position en long.

← Migrer de la 3.0 à la 4.0 · Sommaire · Notes de version →