12. Migrare dalla 4.0 alla 5.0 #

← Migrare dalla 3.0 alla 4.0 · Sommario · Note di versione →

La 5.0 non cambia alcuna firma dei trentasette componenti della 4.0, né alcun evento — tranne la barra di pulsanti (buttonbar, 12.7) e l'evento ue_link_clicked del visualizzatore Markdown (markdownview), che riceve un secondo argomento, as_kind (12.5). Tre componenti cambiano parole. La barra di avanzamento (progressbar) prende quelle degli indicatori — ib_label, il_color e is_label_format scompaiono a favore di ib_show_value, il_value_color, is_format e is_unit (12.1). Il grafico cartesiano (chartcartesian) scrive i suoi numeri tramite is_format, come gli indicatori e il grafico a torta: of_set_value_format e of_clear_value_format scompaiono, e ii_point_count di una serie diventa il_point_count (12.4). La tabella pivot (crosstab) segue la stessa strada: of_set_value_format e of_clear_value_format scompaiono a favore di is_format — sul campo, o su un solo valore tramite of_value — e di ib_negative_red (12.8). Il compilatore Le mostra ogni riga da riprendere. La barra laterale (listbar) cambia un evento: ue_item_rclicked riceve in più il punto dello schermo del clic, al_x e al_y (12.9). Il pannello di riquadri (tilesbox) rinomina un evento: ue_tile_context(as_keys) diventa ue_tile_rclicked(as_keys, al_x, al_y), e la posizione di of_move_tile e di of_insert_tile diventa long al_position (12.12). Il menu radiale (radialmenu) perde quattro proprietà di descrizione comando che non ha mai mostrato — is_tooltip, is_super_tooltip_title, is_super_tooltip_text e is_super_tooltip_image (12.5). Il calendario (scheduler) cambia tre eventi di gesto: ue_appointment_changing riceve as_kind, ue_appointment_moved e ue_appointment_resized ricevono i valori precedenti (12.10). L'esploratore della shell (shellexplorer) cambia un evento: ue_error riceve in più il percorso e un motivo costante, as_path e as_reason (12.11). Il blocco di testo formattato (statictext) cambia un evento: ue_hyperlink riceve in più ab_opened, se il collegamento si è davvero aperto (12.5). La scheda (tab) cambia un evento: ue_tab_rclicked riceve in più il punto dello schermo del clic, al_x e al_y (12.13). Il lettore di suoni (soundplayer) cambia tre eventi: ue_started, ue_ended e ue_failed ricevono in più il numero del suono, al_sound (12.14). Il toaster (toaster) cambia un evento: ue_toast_dismissed riceve in più il motivo della chiusura, as_reason (12.15). Il browser web (webbrowser): of_go_back, of_go_forward e of_stop restituiscono un long, e con ib_veto_navigation un indirizzo digitato dall'utente viene chiesto a ue_navigating (12.17). La barra degli strumenti (toolbar) cambia un evento: ue_item_rclicked riceve in più il punto dello schermo del clic, al_x e al_y (12.18). Il lettore video (video) cambia una firma: of_stop diventa una funzione che rende un long (12.16) — una chiamata scritta come istruzione compila ancora. Tre componenti cambiano un evento di clic destro di un elemento, che riceve in più il suo punto dello schermo al_x, al_y: la barra di pulsanti (ue_button_rclicked), il percorso (breadcrumb, ue_item_rclicked) e il grafico cartesiano (ue_point_rclicked); la barra di stato (statusbar) dà quel punto come gli altri, senza più moltiplicarlo per la scala dello schermo (12.19). La base (12.20): il motivo del fallimento di un componente non visuale si legge con of_get_last_error() — la proprietà is_last_error scompare da crypto, restclient, soundplayer, speechout, xml, u_pbt_regex e u_pbt_zip —, e of_stop, of_close e of_reset dei componenti non visuali restituiscono un long.

Il resto non chiede nulla al Suo codice: la griglia dati (datagrid) e la barra multifunzione (ribbon) ottengono maschere di input numeriche, e l'editor di una colonna numerica della griglia si apre ora sul testo della maschera (12.2, 12.3). I nuovi componenti della 5.0 sono presentati nelle note di versione.

12.1 progressbar: le parole degli indicatori #

La 5.0 porta due indicatori, lineare (gauge) e a quadrante (angulargauge). Anche una barra di avanzamento mostra un valore su una scala: la libreria parla ormai una sola lingua per questo, e la barra, che diceva la stessa cosa con altre parole, prende le parole degli indicatori. Nessun vecchio nome sopravvive: né una proprietà, né un nome accettato da of_set_property.

• is_format è un formato di visualizzazione PowerBuilder applicato al valore ("#,##0", "$#,##0.00"), con i separatori della lingua di visualizzazione, esattamente come per gli indicatori. Vuoto, la barra mostra la percentuale, come prima.
• I segnaposto {percent}, {value}, {min} e {max} non esistono più. Un'etichetta che mescolava valore e percentuale ("{value} of {max} rows ({percent})") non ha un equivalente esatto: scelga il valore (formato e unità) o la percentuale (e un'unità). Il massimo, che il Suo codice conosce, si scrive nell'unità.
• is_unit è nuovo: un testo semplice scritto dopo la lettura, separato da uno spazio — dopo il valore come dopo la percentuale. of_reset lo svuota.
• Una maschera che contiene % scrive la parte compiuta, non il valore: is_format = "0.0%" dà «35.0%» per 1.687 righe su 4.820, arrotondata per difetto come la percentuale — la percentuale con decimali che {percent} non sapeva scrivere.
• Un'attesa in pausa o in errore diventa una barra piena. Nella 4.0, una barra di attesa (ib_indeterminate) che riceveva STATE_PAUSED o STATE_ERROR si bloccava nel suo scorrimento, spesso fuori dalla traccia: l'errore non si vedeva. Nella 5.0 si ferma come barra (anello) piena del colore dello stato, come la barra delle applicazioni di Windows, e il lettore di schermo non la annuncia più occupata ma ne dice lo stato.
• of_set_property("tooltip", …) e super_tooltip_* restituiscono -5: la barra non espone tooltip, e la porta per nome, che ne impostava uno, è chiusa come le proprietà.
• Novità, senza nulla da riprendere: is_orientation (ORIENTATION_VERTICAL: una barra verticale, al posto di una VProgressBar), is_accessible_name (il nome che dice il lettore di schermo) e il testo di un'attesa (solo is_unit mentre la barra è in attesa).

// 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 ricetta: compili; ogni ib_label, il_color e is_label_format di una barra di avanzamento viene segnalato. Sostituisca i primi due con ib_show_value e il_value_color. Per il terzo: un testo vuoto resta vuoto in is_format; un'etichetta che scriveva il valore diventa un formato ("#,##0") e un'unità; un'etichetta che scriveva la percentuale lascia is_format vuoto e mette il suo testo in is_unit. Un of_set_property che nominava label, label_format o color ora restituisce -5 e non fa nulla (of_get_last_error nomina la proprietà): cerchi questi nomi nel Suo codice.

12.2 datagrid: un editor numerico che digita attraverso una maschera #

Nessuna firma cambia, e ue_cell_edited riceve sempre il numero nudo (1234.5). Ciò che cambia si vede sullo schermo: la digitazione in una colonna numerica segue ora una maschera di input, nella sintassi della DataWindow — quella che indica con la nuova proprietà is_mask della colonna, altrimenti il suo formato di visualizzazione privato dei letterali.

// 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 ricetta: niente da cambiare. Un codice che leggeva il testo digitato non lo vede: ue_cell_edited restituisce sempre il numero. Una colonna la cui digitazione deve restare libera (un codice, un numero di pezzo) è una colonna di testo, non numerica.

12.3 ribbon: le maschere di un contatore #

Nulla cambia per un contatore senza maschera. Due nuove proprietà del suo handle, nella sintassi di PowerBuilder: is_mask, la maschera di input ("#,##0.00", "0%"), e is_format, il formato di visualizzazione con i suoi letterali (0 "pt" mostra 11 pt, digitato 11). id_value e ue_value_changed mantengono il numero nudo, il passaggio dall'uno all'altro non solleva alcun evento, e le maschere seguono il contatore nel pannello di un gruppo compresso.

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

La ricetta: niente da cambiare.

12.4 chartcartesian: il formato dei numeri tramite is_format #

Il grafico cartesiano scriveva i suoi numeri con una funzione a quattro argomenti (decimali, prefisso, suffisso, separatore delle migliaia). La 5.0 mette grafici e indicatori sotto una sola lingua: un formato di visualizzazione PowerBuilder, quello di una colonna DataWindow, nella proprietà is_format — del grafico intero, e di un asse tramite il suo handle. Le sezioni positivo;negativo;zero, i letterali e la percentuale vengono con esso, e i separatori restano quelli della lingua di visualizzazione. Nessun vecchio nome sopravvive.

• Il formato di un asse prevale su quello del grafico, e lo mantiene. Impostare il formato del grafico non cancella più quello degli assi (la forma di of_set_value_format senza asse lo faceva): un asse torna al formato del grafico con is_format = "".
• Senza formato (vuoto, o un formato non numerico), il numero si scrive così com'è, al millesimo, con il separatore decimale della lingua di visualizzazione — come faceva il formato predefinito.

// 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 ricetta: compili; ogni of_set_value_format e of_clear_value_format viene segnalato. Scriva il formato come in una DataWindow: decimals dà il numero di 0 dopo il punto (-1 = #,##0.###), thousands la , del raggruppamento, prefisso e suffisso si scrivono davanti e dietro (tra virgolette se contengono cifre o spazi). Il formato di un asse va in of_axis(<asse>).is_format.

12.5 Altri comportamenti che può notare #

La ricetta: niente da cambiare.

12.6 Ciò che è stato aggiunto #

Nulla di quanto segue chiede di modificare il codice. Gli otto nuovi componenti della 5.0 sono presentati nelle note di versione.

12.7 buttonbar: chiave, etichetta, poi icona; la « & » e la combinazione #

La barra di pulsanti parlava diversamente dal resto della libreria: l'icona prima dell'etichetta, la posizione come secondo argomento, e un is_shortcut che voleva dire « lettera Alt » dove ovunque altrove vuol dire « combinazione » — is_shortcut = "Ctrl+S" armava Alt+C. La 5.0 la allinea a button, alla barra degli strumenti e al CommandButton di PowerBuilder.

• is_shortcut di un pulsante è una combinazione. Durante la 5.0, una lettera da sola vi è ancora letta come la lettera Alt della 4.0 (passa in is_mnemonic); scriva piuttosto la « & » nell'etichetta. Una combinazione che la finestra non può mai sollevare (una lettera da sola, Ctrl+Shift) è rifiutata: is_shortcut si rilegge vuoto, of_register_shortcut restituisce -5.
• Un pulsante disabilitato non ruba più un tasto. Il pulsante predefinito disabilitato di una barra, o la lettera Alt di un pulsante disabilitato, lascia Invio e la lettera alla finestra — non vanno più al pulsante di UN'ALTRA barra (due fogli MDI); la combinazione di un pulsante disabilitato lascia il suo tasto alla finestra (un acceleratore di menu, per esempio). Le frecce saltano un pulsante disabilitato.

// 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 ricetta: compili; una chiamata di of_insert_button è segnalata (la posizione va per ultima). Un of_add_button a tre argomenti compila ancora: scambi gli ultimi due (l'etichetta, poi l'icona) — un pulsante la cui etichetta è un percorso di file Le mostra quelli rimasti. Sostituisca ogni is_shortcut di una lettera con una « & » nell'etichetta, e raddoppi ogni « & » che deve essere mostrata (R&&D).

12.8 crosstab: il formato dei valori tramite is_format #

La tabella pivot scriveva i numeri di una misura con una funzione a quattro o cinque argomenti (decimali, separatore delle migliaia, simbolo, simbolo davanti), che valeva per tutti i valori di un campo: lo stesso campo due volte in Valori — l'importo, e la sua quota del totale — non poteva avere due formati. La 5.0 lo mette sotto la lingua dei grafici e degli indicatori: un formato di visualizzazione PowerBuilder in is_format, sull'handle del campo (of_field) per tutti i suoi valori, o sull'handle di un valore (of_value(position), nuovo) per esso solo. Vuoto, un valore prende il Format della colonna del DataWindow. Nessun vecchio nome sopravvive.

• Il separatore delle migliaia di un valore senza formato resta is_thousands, come il menu Opzioni della griglia: è ciò che faceva un of_set_value_format con separatore vuoto. La valuta che propone il menu del chip resta is_currency_symbol.
• Un valore senza formato mostra ora il Format della sua colonna del DataWindow, letto da of_from_datastore: un importo la cui colonna porta #,##0.00 si mostra con due decimali senza una riga di codice.

// 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 ricetta: compili; ogni of_set_value_format e of_clear_value_format viene segnalato. Scriva il formato come in una DataWindow: ai_decimals dà il numero di 0 dopo il punto, un separatore delle migliaia dà la , del raggruppamento ("none": nessuno), il simbolo si scrive davanti o dietro (tra virgolette se contiene cifre o spazi). Il formato di un solo valore va in of_value(<posizione>).is_format.

12.9 listbar: il clic destro porta il suo punto, una disposizione si annuncia #

La barra laterale si allinea alla libreria su tre punti: il clic destro di una voce dà il suo punto dello schermo come quello degli alberi, delle griglie e del kanban; un ordine del codice che cambia la disposizione la annuncia come un gesto; una voce disattivata non diventa più la selezione. Guadagna anche un evento per il clic sulla voce già selezionata, una ricerca e la costruzione da 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 ricetta: nulla rifiuta di compilare — uno script di ue_item_rclicked conserva as_keys. Aprite il vostro menu al puntatore della finestra (parent.PointerX()), o passate al_x, al_y a of_show di un contextmenu. Impostate la selezione iniziale prima di attivare ib_veto_selection, e verificate che il vostro ue_layout_changed accetti la chiamata che of_set_layout ora solleva.

12.10 scheduler: la natura di una modifica e i valori precedenti #

Il calendario si allinea al diagramma di Gantt: la domanda posta prima di un gesto dice se si tratta di uno spostamento o di un ridimensionamento, e gli eventi che seguono danno i valori precedenti — un registro, un annullamento o una conferma non devono più tenere la propria copia di ogni appuntamento. Una selezione che il vostro codice toglie viene annunciata, e quattro chiamate rifiutano ora ciò che accettavano in silenzio.

// 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 ricetta: nulla rifiuta di compilare — uno script di ue_appointment_changing, ue_appointment_moved o ue_appointment_resized conserva i suoi argomenti, i nuovi si aggiungono. Se il vostro ue_selection_changed attiva dei pulsanti, ora riceve "" quando l'appuntamento selezionato sparisce; ricontrollate i codici di ritorno di of_add_appointment, of_scroll_to_time, of_set_field e of_show_appointment, che ora possono restituire -5. Per salvare i gesti senza codice, vedete ib_write_back.

12.11 shellexplorer: l'errore dice il suo motivo #

L'esploratore della shell dà ora, in ue_error come in ue_path_not_found, un motivo che il codice può verificare — una costante REASON_* di u_pbt_shellexplorer, la stessa in ogni lingua di Windows. Non solleva più ue_selected per la cartella già selezionata, e annuncia con ue_collapsed un ramo che chiude da sé. Guadagna anche il clic destro su una cartella (ue_node_rclicked) e l'indirizzo della radice.

// 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 ricetta: nulla rifiuta di compilare — uno script di ue_error conserva as_message, i nuovi argomenti si aggiungono. Una verifica sul TESTO di as_reason in ue_path_not_found ("not found", "outside the root") si riscrive con una costante REASON_*; un'applicazione che ricaricava un riquadro a ogni ue_selected lo fa ora una volta per cambiamento.

12.12 tilesbox: il clic destro porta il suo punto, un ordine del codice si annuncia, la disposizione lascia i diritti all'applicazione #

Il pannello di riquadri si allinea alla libreria: il suo clic destro dà il punto dello schermo come quello degli alberi, delle griglie e del kanban; un ordine del codice che sposta un riquadro, comprime un gruppo o cambia una dimensione solleva gli stessi eventi di un gesto; la disposizione non porta più la visibilità, che resta affare dell'applicazione. Guadagna anche lo spostamento di un riquadro in un altro gruppo dal codice (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 ricetta: compili; il Suo script di ue_tile_context resta su un evento che non esiste più — lo sposti in ue_tile_rclicked, che conserva as_keys. Se il Suo ue_layout_changed salva la disposizione, ora vede anche ciò che il Suo codice cambia; un ue_tile_moved che deve reagire solo all'utente ignora gli spostamenti che il Suo codice ha appena fatto. Se conservava la visibilità nella disposizione, la imposti dal codice all'apertura (ib_visible), secondo i diritti.

12.13 tab: il clic destro porta il suo punto, una disposizione applicata si annuncia #

La scheda si allinea alla libreria: il clic destro di una scheda, con il menu integrato spento, dà il suo punto dello schermo come quello degli alberi, delle griglie e del kanban, e of_set_layout che cambia la disposizione la annuncia come un gesto. Un trascinamento riportato al suo posto non annuncia più nulla. Guadagna anche pagine create su richiesta (ue_page_needed, of_supply_page), il doppio clic (ue_tab_double_clicked), ib_cycle_keys, is_close_mode, ii_strip_width e, su una pagina, ib_modified e is_badge — vedere la pagina della scheda.

// 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 ricetta: nulla rifiuta di compilare — uno script di ue_tab_rclicked conserva as_key. Apra il suo menu al puntatore della finestra (parent.PointerX()), o passi al_x, al_y a of_show di un contextmenu. Verifichi che il suo ue_layout_changed accetti la chiamata che of_set_layout ora gli fa.

12.14 soundplayer: il numero di un suono, un rifiuto reso subito #

Il lettore di suoni cambia tre cose che il Suo codice può vedere. I suoi eventi portano il numero del suono: ue_started, ue_ended e ue_failed ricevono un ultimo argomento, al_sound — il numero che of_play_over e of_enqueue rendono ora (rendevano 0), e che il nuovo of_stop_sound accetta. Una sorgente rifiutata subito è un codice: of_play, of_play_over, of_crossfade e of_preload rendono -5, il motivo in of_get_last_error(), per una sorgente vuota, un indirizzo http://, un indirizzo file:// malformato o un formato rifiutato dal nome — e non sollevano più ue_failed; il suono in corso continua. Nella coda (of_enqueue), il rifiuto arriva sempre tramite ue_failed, al suo turno. Altri -5: of_pause e of_resume senza nulla da sospendere o riprendere, of_beep e of_beep_sync a 0 Hz o 0 ms, of_meter fuori da 1 a 64 barre.

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

Ciò che cambia senza chiedere nulla al Suo codice: of_stop ora si spegne su il_fade_ms, come la documentazione prometteva (ue_stopped arriva sempre subito); alla scadenza di il_timeout_ms, solo il suono della chiamata sincrona è interrotto — lo sfondo, le sovrapposizioni e la coda continuano; of_crossfade verso una sorgente rifiutata conserva la traccia in corso; of_level vale 0 e of_spectrum non rende alcuna barra, a misuratore spento; of_equalizer(ab_on, ai_gains[]) riporta a 0 una banda che l'array non raggiunge; of_clear_queue dimentica anche i suoni che la coda ha già suonato; i messaggi di ue_failed seguono la lingua di visualizzazione (as_reason resta la parola da testare). Il lettore guadagna anche la coda navigabile (of_next, of_previous, of_queue_index, ue_source_changed, ib_queue_repeat), il ciclo senza interruzioni (ib_gapless_loop, REASON_TOO_LONG), il segmento (of_play_range), il muto (ib_muted) e il buffering (ue_buffering, of_is_buffering) — vedere la pagina del lettore di suoni.

La ricetta: nulla rifiuta di compilare — uno script di ue_started, ue_ended o ue_failed conserva i suoi argomenti, al_sound si aggiunge. Ricontrolli i test sul codice di ritorno di of_play_over e of_enqueue (un = 0 diventa > 0), e il codice che attendeva ue_failed per un indirizzo http:// o una sorgente vuota: ora verifica il -5 della chiamata.

12.15 toaster: il motivo di una chiusura, un toast chiuso dal codice si annuncia sempre #

Il toaster dice perché un toast si è chiuso: ue_toast_dismissed riceve un ultimo argomento, as_reason — REASON_TIMEOUT, REASON_USER (la sua croce), REASON_CODE (of_close, of_close_all) o REASON_OWNER_CLOSED (la sua finestra si è chiusa). E ogni toast chiuso dal codice lo annuncia, anche chiuso subito dopo of_show, prima di essere disegnato, o mentre attendeva il suo posto: un'applicazione che attendeva ue_toast_dismissed per liberare il proprio stato non dipende più da una corsa.

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

// 5.0 : lo stesso script, con il motivo
// event ue_toast_dismissed di inv_toaster : (long al_id, string as_key, string as_reason)

La ricetta: nulla rifiuta di compilare — uno script di ue_toast_dismissed conserva al_id e as_key, as_reason si aggiunge. Ricontrolli il codice che supponeva che un toast chiuso subito da of_close non avrebbe detto nulla: ora lo annuncia. I toast restano legati al toaster che li ha mostrati: un of_close sull'identificatore di un altro toaster restituisce -5. Il toaster guadagna anche of_close_all (chiudere tutti i suoi toast) e of_get_last_error — vedere la pagina del toaster.

12.16 video: un rifiuto reso subito, un film e i suoi sottotitoli in una chiamata, lo stesso film ripreso #

Il lettore video cambia cinque cose che il tuo codice può vedere. Un rifiuto è reso subito, come nel lettore di suoni (12.14): of_play(), of_play(source) e of_play_range rendono -5, il motivo in of_get_last_error(), per una sorgente vuota, un indirizzo http:// o un formato rifiutato dal nome (avi, wmv, flv) — e non sollevano più ue_failed; il film in corso continua. La proprietà is_source conserva il suo ue_failed: una proprietà non ha codice di ritorno. Lo stesso film non viene ricaricato: of_play(source) o is_source sul film già caricato lo riprende da dov'è (ue_resumed) invece di farlo ripartire dall'inizio; of_seek(0) lo fa ripartire. Una ricerca resta nel segmento di of_play_range, quella dell'utente come of_seek: Inizio porta all'inizio del segmento, un clic oltre la sua fine alla sua fine — prima, Inizio usciva dall'estratto e un clic oltre fermava il film. Una voce di playlist che non può essere riprodotta solleva prima ue_source_changed, poi un solo ue_failed — arrivava prima, e due volte. of_stop diventa una funzione: non rendeva nulla (subroutine), rende 0, o -2 quando il componente non è creato — come of_stop del browser 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

Ciò che cambia senza chiedere nulla al tuo codice: un marcatore raggiunto da una ricerca IN PAUSA non solleva più ue_marker_reached (solo ue_seeked); Spazio e il pulsante Riproduci di un lettore senza film non fanno più nulla (sollevavano ue_failed(REASON_NO_SOURCE)); la lingua dei sottotitoli scelta dall'utente segue al film successivo della playlist; una locandina http:// è rifiutata e is_poster si rilegge vuota; un is_subtitles rifiutato si rilegge vuoto; un file di sottotitoli della postazione introvabile solleva ue_subtitles_failed(REASON_NOT_FOUND); il menu della velocità si usa da tastiera e le sue frecce non cambiano più il volume; a schermo intero la barra si mostra da tastiera; la posizione ricordata (ib_remember_position) non dipende più da come è scritto il percorso, e sono conservati solo gli ultimi 200 film (una posizione della 4.0 viene riletta una volta). Il lettore guadagna of_play(source, subtitles) (il film e i SUOI sottotitoli: impostati prima di un secondo film, se ne andavano con il primo), ib_forward_seek, of_watched_ms, of_watched_percent, ue_watched_completely e ib_skip_failed — vedi la pagina del lettore video.

La ricetta: nulla rifiuta di compilare. Rileggi il codice che attendeva ue_failed dopo of_play per un indirizzo http://, una sorgente vuota o un .avi: ora verifica il -5 della chiamata. Rileggi anche un pulsante « Riproduci » che contava su of_play(source) per ripartire dall'inizio: aggiungi of_seek(0).

12.17 webbrowser: un gesto dell'utente viene chiesto, una pagina di of_show_html non ha indirizzo #

Con ib_veto_navigation = true, ue_navigating viene ora chiesto anche per un gesto dell'utente: un indirizzo digitato nella barra, Apri collegamento del menu contestuale, una nuova finestra aperta da un clic. Nella 4.0 questi tre percorsi non chiedevano nulla. Solo un indirizzo impostato dal Suo codice non viene mai chiesto, e nemmeno un reindirizzamento del server: per un elenco di server che valga anche per i reindirizzamenti, imposti la nuova proprietà is_allowed_hosts.

La ricetta: nulla rifiuta di compilare, un long ignorato compila. Uno script di ue_navigating scritto per i collegamenti del sito vede ora anche gli indirizzi digitati dall'utente: se decide in base all'indirizzo, confronti il suo host, come l'esempio della pagina del componente — oppure affidi l'elenco a is_allowed_hosts. Il codice che leggeva as_url di ue_load_completed, o is_address, dopo of_show_html riceve una stringa vuota.

12.18 toolbar: il clic destro porta il suo punto, un ordine del codice si annuncia #

La barra degli strumenti si allinea alla libreria: il clic destro di uno strumento dà il suo punto dello schermo, come quello degli alberi, delle griglie e della scheda, e spostare una barra con ii_band / ii_index scatena ue_bar_reordered come il gesto. Due aggiunte rifiutano ciò che accettavano in silenzio, e una scorciatoia posta dove nulla vive non viene più registrata. Guadagna anche is_text su una barra, un nome per ogni strumento e ogni campo letto da un lettore di schermo, e una tastiera che attraversa i campi — vedere la pagina della barra degli strumenti.

// 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 ricetta: nulla rifiuta di compilare — uno script di ue_item_rclicked conserva as_keys. Aprite il vostro menu al punto al_x, al_y (passatelo a of_show di un contextmenu). Verificate che uno script di ue_bar_reordered accetti anche gli spostamenti fatti dal vostro codice, testate il codice di ritorno di of_add_datepicker se la data viene da un campo regionale, e impostate is_shortcut dopo l'aggiunta dello strumento o della voce.

12.19 Il clic destro di un elemento porta il suo punto: buttonbar, breadcrumb, chartcartesian, statusbar #

Una sola regola per ogni clic destro su un elemento della libreria: l'evento riceve la chiave (o l'indirizzo) dell'elemento, poi al_x, al_y, il punto dove aprire un menu, in pixel dello schermo — il puntatore, o, da tastiera (tasto Menu, Maiusc+F10), l'angolo in basso a sinistra dell'elemento (in basso a destra in una lettura da destra a sinistra; il centro di una forma che non è un rettangolo: un punto di un grafico). Un contextmenu della libreria vi si apre così com'è: uo_menu.of_show(al_x, al_y). Tre eventi che non lo portavano lo ricevono; la barra di stato moltiplicava il suo per la scala dello schermo, e un menu aperto in quel punto finiva lontano dal puntatore su uno schermo al 125 % o al 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 ricetta: nulla rifiuta di compilare — uno script di questi eventi conserva i suoi argomenti. Aprite il vostro menu al punto al_x, al_y (passatelo a of_show di un contextmenu); un menu PowerBuilder conserva PopMenu(PointerX(), PointerY()) della vostra finestra. Uno script che correggeva da sé la scala delle coordinate di ue_panel_rclicked non deve più farlo.

12.20 La base: l'errore di un componente è il suo, ogni verbo restituisce un codice #

Cinque cambiamenti toccano tutta la libreria, o tutta una famiglia di componenti. Uno solo rifiuta di compilare: is_last_error di un componente non visuale, diventato 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 ricetta: il compilatore mostra ogni .is_last_error da sostituire con .of_get_last_error(). Una chiamata a of_stop, of_close o of_reset scritta come istruzione compila sempre. Uno script che leggeva of_get_last_error() di un componente per conoscere il fallimento di un'altra chiamata (un export della DLL chiamato direttamente, un altro componente) legge ora il motivo di quel componente, o niente: chiedetelo a chi è fallito.

Aggiunto, niente da rifare: is_accessible_name e is_accessible_description su tutti i componenti visuali — il nome e la descrizione che dice un lettore di schermo (3.4); of_from_datastore di un DataWindow o di un DataWindowChild su crosstab e datagrid, come sugli altri componenti legati ai dati; la forma completa di of_insert_command (commandpalette), che prende la spiegazione, la combinazione e le parole chiave come of_add_command, con una posizione in long.

← Migrare dalla 3.0 alla 4.0 · Sommario · Note di versione →