12. Migrar de la 4.0 a la 5.0 #

← Migrar de la 3.0 a la 4.0 · Índice · Notas de la versión →

La 5.0 no cambia ninguna firma de los treinta y siete componentes de la 4.0, ni ningún evento — salvo la barra de botones (buttonbar, 12.7) y el evento ue_link_clicked del visor Markdown (markdownview), que recibe un segundo argumento, as_kind (12.5). Tres componentes cambian de palabras. La barra de progreso (progressbar) adopta las de los indicadores — ib_label, il_color e is_label_format desaparecen en favor de ib_show_value, il_value_color, is_format e is_unit (12.1). El gráfico cartesiano (chartcartesian) escribe sus números mediante is_format, como los indicadores y el gráfico circular: of_set_value_format y of_clear_value_format desaparecen, y ii_point_count de una serie pasa a ser il_point_count (12.4). La tabla dinámica (crosstab) sigue el mismo camino: of_set_value_format y of_clear_value_format desaparecen en favor de is_format — en el campo, o en un solo valor mediante of_value — y de ib_negative_red (12.8). El compilador le muestra cada línea que hay que retocar. La barra lateral (listbar) cambia un evento: ue_item_rclicked recibe además el punto de pantalla del clic, al_x y al_y (12.9). El panel de mosaicos (tilesbox) renombra un evento: ue_tile_context(as_keys) pasa a ser ue_tile_rclicked(as_keys, al_x, al_y), y la posición de of_move_tile y de of_insert_tile pasa a long al_position (12.12). El menú radial (radialmenu) pierde cuatro propiedades de información sobre herramientas que nunca mostró — is_tooltip, is_super_tooltip_title, is_super_tooltip_text e is_super_tooltip_image (12.5). El calendario (scheduler) cambia tres eventos de gesto: ue_appointment_changing recibe as_kind, ue_appointment_moved y ue_appointment_resized reciben los valores anteriores (12.10). El explorador del shell (shellexplorer) cambia un evento: ue_error recibe además la ruta y un motivo constante, as_path y as_reason (12.11). El bloque de texto enriquecido (statictext) cambia un evento: ue_hyperlink recibe además ab_opened, si el enlace se abrió de verdad (12.5). La pestaña (tab) cambia un evento: ue_tab_rclicked recibe además el punto de pantalla del clic, al_x y al_y (12.13). El reproductor de sonidos (soundplayer) cambia tres eventos: ue_started, ue_ended y ue_failed reciben además el número del sonido, al_sound (12.14). El toaster (toaster) cambia un evento: ue_toast_dismissed recibe además el motivo del cierre, as_reason (12.15). El navegador web (webbrowser): of_go_back, of_go_forward y of_stop devuelven un long, y con ib_veto_navigation una dirección escrita por el usuario se pregunta a ue_navigating (12.17). La barra de herramientas (toolbar) cambia un evento: ue_item_rclicked recibe además el punto de pantalla del clic, al_x y al_y (12.18). El reproductor de vídeo (video) cambia una firma: of_stop pasa a ser una función que devuelve un long (12.16) — una llamada escrita como instrucción sigue compilando. Tres componentes cambian un evento de clic derecho de un elemento, que recibe además su punto de pantalla al_x, al_y: la barra de botones (ue_button_rclicked), la ruta de navegación (breadcrumb, ue_item_rclicked) y el gráfico cartesiano (ue_point_rclicked); la barra de estado (statusbar) da ese punto como los demás, sin multiplicarlo ya por la escala de la pantalla (12.19). La base (12.20): el motivo del fallo de un componente no visual se lee con of_get_last_error() — la propiedad is_last_error desaparece de crypto, restclient, soundplayer, speechout, xml, u_pbt_regex y u_pbt_zip —, y of_stop, of_close y of_reset de los componentes no visuales devuelven un long.

El resto no pide nada a su código: la cuadrícula de datos (datagrid) y la cinta (ribbon) ganan máscaras de entrada numéricas, y el editor de una columna numérica de la cuadrícula se abre ahora sobre el texto de la máscara (12.2, 12.3). Los nuevos componentes de la 5.0 se presentan en las notas de la versión.

12.1 progressbar: las palabras de los indicadores #

La 5.0 trae dos indicadores, lineal (gauge) y de esfera (angulargauge). Una barra de progreso también muestra un valor sobre una escala: la biblioteca ya solo habla un idioma para ello, y la barra, que decía lo mismo con otras palabras, adopta las palabras de los indicadores. Ningún nombre antiguo sobrevive: ni una propiedad, ni un nombre aceptado por of_set_property.

• is_format es un formato de visualización de PowerBuilder aplicado al valor ("#,##0", "$#,##0.00"), con los separadores del idioma de visualización, exactamente como en los indicadores. Vacío, la barra muestra el porcentaje, como antes.
• Los marcadores {percent}, {value}, {min} y {max} ya no existen. Una etiqueta que mezclaba valor y porcentaje ("{value} of {max} rows ({percent})") no tiene equivalente exacto: elija el valor (formato y unidad) o el porcentaje (y una unidad). El máximo, que su código conoce, se escribe en la unidad.
• is_unit es nuevo: un texto plano escrito tras la lectura, separado por un espacio — tras el valor como tras el porcentaje. of_reset lo vacía.
• Una máscara que contiene % escribe la parte realizada, no el valor: is_format = "0.0%" da «35.0%» para 1.687 filas de 4.820, redondeada hacia abajo como el porcentaje — el porcentaje con decimales que {percent} no sabía escribir.
• Una espera en pausa o en error se convierte en una barra llena. En la 4.0, una barra de espera (ib_indeterminate) que recibía STATE_PAUSED o STATE_ERROR se congelaba en su deslizamiento, a menudo fuera de su pista: el fallo no se veía. En la 5.0 se detiene como barra (anillo) llena del color del estado, como la barra de tareas de Windows, y el lector de pantalla ya no la anuncia ocupada sino que dice su estado.
• of_set_property("tooltip", …) y super_tooltip_* devuelven -5: la barra no publica tooltip, y la puerta por nombre, que ponía uno, está cerrada como las propiedades.
• Novedad, sin nada que retocar: is_orientation (ORIENTATION_VERTICAL: una barra de pie, en lugar de una VProgressBar), is_accessible_name (el nombre que dice el lector de pantalla) y el texto de una espera (solo is_unit mientras la barra está en espera).

// 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 receta: compile; cada ib_label, il_color e is_label_format de una barra de progreso queda señalado. Sustituya los dos primeros por ib_show_value e il_value_color. Para el tercero: un texto vacío sigue vacío en is_format; una etiqueta que escribía el valor pasa a ser un formato ("#,##0") y una unidad; una etiqueta que escribía el porcentaje deja is_format vacío y pone su texto en is_unit. Un of_set_property que nombraba label, label_format o color ahora devuelve -5 y no hace nada (of_get_last_error nombra la propiedad): busque esos nombres en su código.

12.2 datagrid: un editor numérico que teclea a través de una máscara #

Ninguna firma cambia, y ue_cell_edited sigue recibiendo el número desnudo (1234.5). Lo que cambia se ve en pantalla: la escritura en una columna numérica sigue ahora una máscara de entrada, en la sintaxis del DataWindow — la que usted da con la nueva propiedad is_mask de la columna, si no su formato de visualización despojado de sus literales.

// 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 receta: nada que cambiar. Un código que leía el texto tecleado no lo ve: ue_cell_edited sigue devolviendo el número. Una columna cuya entrada debe quedar libre (un código, un número de pieza) es una columna de texto, no numérica.

12.3 ribbon: las máscaras de un contador #

Nada cambia para un contador sin máscara. Dos propiedades nuevas de su handle, en la sintaxis de PowerBuilder: is_mask, la máscara de entrada ("#,##0.00", "0%"), e is_format, el formato de visualización con sus literales (0 "pt" muestra 11 pt, que se teclea 11). id_value y ue_value_changed conservan el número desnudo, el cambio entre ambos no lanza ningún evento, y las máscaras siguen al contador en el panel de un grupo contraído.

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

La receta: nada que cambiar.

12.4 chartcartesian: el formato de los números mediante is_format #

El gráfico cartesiano escribía sus números con una función de cuatro argumentos (decimales, prefijo, sufijo, separador de miles). La 5.0 pone gráficos e indicadores bajo un solo idioma: un formato de visualización de PowerBuilder, el de una columna de DataWindow, en la propiedad is_format — del gráfico entero, y de un eje mediante su handle. Las secciones positivo;negativo;cero, los literales y el porcentaje vienen con él, y los separadores siguen siendo los del idioma de visualización. Ningún nombre antiguo sobrevive.

• El formato de un eje prevalece sobre el del gráfico, y lo conserva. Poner el formato del gráfico ya no borra el de los ejes (la forma de of_set_value_format sin eje lo hacía): un eje vuelve al formato del gráfico con is_format = "".
• Sin formato (vacío, o un formato que no es numérico), el número se escribe tal cual, a la milésima, con el separador decimal del idioma de visualización — como hacía el formato predeterminado.

// 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 receta: compile; cada of_set_value_format y of_clear_value_format queda señalado. Escriba el formato como en un DataWindow: decimals da el número de 0 tras el punto (-1 = #,##0.###), thousands la , de agrupación, el prefijo y el sufijo se escriben delante y detrás (entre comillas si contienen cifras o espacios). El formato de un eje va en of_axis(<eje>).is_format.

12.5 Otros comportamientos que puede ver #

La receta: nada que cambiar.

12.6 Lo que se ha añadido #

Nada de lo siguiente pide modificar su código. Los ocho nuevos componentes de la 5.0 se presentan en las notas de la versión.

12.7 buttonbar: clave, etiqueta y luego icono; el « & » y el atajo #

La barra de botones hablaba distinto del resto de la biblioteca: el icono antes de la etiqueta, la posición como segundo argumento, y un is_shortcut que quería decir « letra Alt » donde en todas partes quiere decir « atajo » — is_shortcut = "Ctrl+S" armaba Alt+C. La 5.0 la alinea con button, la barra de herramientas y el CommandButton de PowerBuilder.

• is_shortcut de un botón es un atajo. Durante la 5.0, una letra sola todavía se lee ahí como la letra Alt de la 4.0 (pasa a is_mnemonic); escriba mejor el « & » en la etiqueta. Un atajo que la ventana nunca puede lanzar (una letra sola, Ctrl+Shift) se rechaza: is_shortcut se relee vacío, of_register_shortcut devuelve -5.
• Un botón deshabilitado ya no roba una tecla. El botón predeterminado deshabilitado de una barra, o la letra Alt de un botón deshabilitado, deja Intro y la letra a la ventana — ya no van al botón de OTRA barra (dos hojas MDI); el atajo de un botón deshabilitado deja su tecla a la ventana (un acelerador de menú, por ejemplo). Las flechas saltan un botón deshabilitado.

// 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 receta: compile; una llamada de of_insert_button queda señalada (la posición pasa al final). Un of_add_button de tres argumentos sigue compilando: intercambie los dos últimos (la etiqueta y luego el icono) — un botón cuya etiqueta es una ruta de archivo le muestra los que quedan. Sustituya cada is_shortcut de una letra por un « & » en la etiqueta, y duplique todo « & » que deba mostrarse (R&&D).

12.8 crosstab: el formato de los valores mediante is_format #

La tabla dinámica escribía los números de una medida con una función de cuatro o cinco argumentos (decimales, separador de miles, símbolo, símbolo delante), que valía para todos los valores de un campo: el mismo campo dos veces en Valores — el importe, y su parte del total — no podía tener dos formatos. La 5.0 lo pone bajo el idioma de los gráficos y los indicadores: un formato de visualización de PowerBuilder en is_format, en el handle del campo (of_field) para todos sus valores, o en el handle de un valor (of_value(position), nuevo) solo para él. Vacío, un valor toma el Format de la columna del DataWindow. Ningún nombre antiguo sobrevive.

• El separador de miles de un valor sin formato sigue siendo is_thousands, como el menú Opciones de la cuadrícula: es lo que hacía un of_set_value_format con separador vacío. La moneda que propone el menú del chip sigue siendo is_currency_symbol.
• Un valor sin formato muestra ahora el Format de su columna del DataWindow, leído por of_from_datastore: un importe cuya columna lleva #,##0.00 se muestra con dos decimales sin una línea de código.

// 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 receta: compile; cada of_set_value_format y of_clear_value_format queda señalado. Escriba el formato como en un DataWindow: ai_decimals da el número de 0 tras el punto, un separador de miles da la , de agrupación ("none": ninguno), el símbolo se escribe delante o detrás (entre comillas si contiene cifras o espacios). El formato de un solo valor va en of_value(<posición>).is_format.

12.9 listbar: el clic derecho lleva su punto, una disposición se anuncia #

La barra lateral se une a la biblioteca en tres puntos: el clic derecho de una entrada da su punto de pantalla como el de los árboles, las rejillas y el kanban; una orden del código que cambia la disposición la anuncia como un gesto; una entrada atenuada ya no se convierte en la selección. Gana también un evento para el clic en la entrada ya seleccionada, una búsqueda y la construcción desde 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 receta: nada se niega a compilar — un script de ue_item_rclicked conserva as_keys. Abra su menú en el puntero de la ventana (parent.PointerX()), o pase al_x, al_y a of_show de un contextmenu. Ponga la selección inicial antes de activar ib_veto_selection, y compruebe que su ue_layout_changed acepta la llamada que of_set_layout dispara ahora.

12.10 scheduler: la naturaleza de un cambio y los valores anteriores #

El calendario se une al diagrama de Gantt: la pregunta hecha antes de un gesto dice si se trata de un desplazamiento o de un redimensionamiento, y los eventos que siguen dan los valores anteriores — un registro, una anulación o una confirmación ya no tienen que guardar su propia copia de cada cita. Una selección que su código quita se anuncia, y cuatro llamadas rechazan ahora lo que aceptaban en silencio.

// 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 receta: nada se niega a compilar — un script de ue_appointment_changing, ue_appointment_moved o ue_appointment_resized conserva sus argumentos, los nuevos se añaden. Si su ue_selection_changed activa botones, ahora recibe "" cuando la cita seleccionada desaparece; revise los códigos de retorno de of_add_appointment, of_scroll_to_time, of_set_field y of_show_appointment, que ahora pueden devolver -5. Para guardar los gestos sin código, vea ib_write_back.

12.11 shellexplorer: el error dice su motivo #

El explorador del shell da ahora, en ue_error como en ue_path_not_found, un motivo que su código puede comprobar — una constante REASON_* de u_pbt_shellexplorer, la misma en todos los idiomas de Windows. Ya no dispara ue_selected para la carpeta ya seleccionada, y anuncia con ue_collapsed una rama que cierra por sí mismo. Gana también el clic derecho en una carpeta (ue_node_rclicked) y la dirección de la raíz.

// 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 receta: nada se niega a compilar — un script de ue_error conserva as_message, los nuevos argumentos se añaden. Una comprobación del TEXTO de as_reason en ue_path_not_found ("not found", "outside the root") se reescribe con una constante REASON_*; una aplicación que recargaba un panel en cada ue_selected lo hace ahora una vez por cambio.

12.12 tilesbox: el clic derecho lleva su punto, una orden del código se anuncia, la disposición deja los permisos a la aplicación #

El panel de mosaicos se une a la biblioteca: su clic derecho da el punto de pantalla como el de los árboles, las rejillas y el kanban; una orden del código que mueve un mosaico, pliega un grupo o cambia un tamaño lanza los mismos eventos que un gesto; la disposición ya no lleva la visibilidad, que sigue siendo asunto de la aplicación. Gana también el movimiento de un mosaico a otro grupo desde el código (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 receta: compile; su script de ue_tile_context queda en un evento que ya no existe — muévalo a ue_tile_rclicked, que conserva as_keys. Si su ue_layout_changed guarda la disposición, ahora ve también lo que su código cambia; un ue_tile_moved que solo debe reaccionar al usuario ignora los movimientos que su código acaba de hacer. Si guardaba la visibilidad en la disposición, fíjela desde el código en la apertura (ib_visible), según los permisos.

12.13 tab: el clic derecho lleva su punto, una disposición aplicada se anuncia #

La pestaña se une a la biblioteca: el clic derecho de una pestaña, con el menú integrado desactivado, da su punto de pantalla como el de los árboles, las rejillas y el kanban, y of_set_layout que cambia la disposición la anuncia como un gesto. Un arrastre devuelto a su sitio ya no anuncia nada. Gana también páginas creadas bajo demanda (ue_page_needed, of_supply_page), el doble clic (ue_tab_double_clicked), ib_cycle_keys, is_close_mode, ii_strip_width y, en una página, ib_modified e is_badge — vea la página de la pestaña.

// 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 receta: nada se niega a compilar — un script de ue_tab_rclicked conserva as_key. Abra su menú en el puntero de la ventana (parent.PointerX()), o pase al_x, al_y a of_show de un contextmenu. Compruebe que su ue_layout_changed acepta la llamada que of_set_layout le hace ahora.

12.14 soundplayer: el número de un sonido, un rechazo devuelto al instante #

El reproductor de sonidos cambia tres cosas que su código puede ver. Sus eventos llevan el número del sonido: ue_started, ue_ended y ue_failed reciben un último argumento, al_sound — el número que ahora devuelven of_play_over y of_enqueue (devolvían 0), y que toma el nuevo of_stop_sound. Una fuente rechazada de entrada es un código: of_play, of_play_over, of_crossfade y of_preload devuelven -5, la razón en of_get_last_error(), para una fuente vacía, una dirección http://, una dirección file:// mal formada o un formato rechazado por su nombre — y ya no lanzan ue_failed; el sonido en curso continúa. En la cola (of_enqueue), el rechazo llega siempre por ue_failed, en su turno. Otros -5: of_pause y of_resume sin nada que suspender o reanudar, of_beep y of_beep_sync a 0 Hz o 0 ms, of_meter fuera de 1 a 64 barras.

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

Lo que cambia sin pedir nada a su código: of_stop ahora se apaga sobre il_fade_ms, como prometía la documentación (ue_stopped sigue llegando al instante); al vencer il_timeout_ms, solo se corta el sonido de la llamada síncrona — el fondo, las superposiciones y la cola continúan; of_crossfade hacia una fuente rechazada conserva la pista en curso; of_level vale 0 y of_spectrum no devuelve ninguna barra, con el medidor apagado; of_equalizer(ab_on, ai_gains[]) devuelve a 0 una banda que el array no alcanza; of_clear_queue olvida también los sonidos que la cola ya ha sonado; los mensajes de ue_failed siguen el idioma de visualización (as_reason sigue siendo la palabra que comprobar). El reproductor gana también la cola navegable (of_next, of_previous, of_queue_index, ue_source_changed, ib_queue_repeat), el bucle sin cortes (ib_gapless_loop, REASON_TOO_LONG), el segmento (of_play_range), el silencio (ib_muted) y el almacenamiento en búfer (ue_buffering, of_is_buffering) — vea la página del reproductor de sonidos.

La receta: nada se niega a compilar — un script de ue_started, ue_ended o ue_failed conserva sus argumentos, al_sound se añade. Revise las comprobaciones del código de retorno de of_play_over y of_enqueue (un = 0 pasa a > 0), y el código que esperaba ue_failed para una dirección http:// o una fuente vacía: ahora comprueba el -5 de la llamada.

12.15 toaster: el motivo de un cierre, un toast cerrado por el código siempre lo anuncia #

El toaster dice por qué se cerró un toast: ue_toast_dismissed recibe un último argumento, as_reason — REASON_TIMEOUT, REASON_USER (su aspa), REASON_CODE (of_close, of_close_all) o REASON_OWNER_CLOSED (su ventana se cerró). Y todo toast cerrado por el código lo anuncia, incluso cerrado justo después de of_show, antes de dibujarse, o mientras esperaba su sitio: una aplicación que esperaba ue_toast_dismissed para liberar su estado ya no depende de una carrera.

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

// 5.0 : el mismo script, con el motivo
// event ue_toast_dismissed de inv_toaster : (long al_id, string as_key, string as_reason)

La receta: nada se niega a compilar — un script de ue_toast_dismissed conserva al_id y as_key, as_reason se añade. Revise el código que suponía que un toast cerrado enseguida por of_close no diría nada: ahora lo anuncia. Los toasts siguen ligados al toaster que los mostró: un of_close sobre el identificador de otro toaster devuelve -5. El toaster gana también of_close_all (cerrar todos sus toasts) y of_get_last_error — véase la página del toaster.

12.16 video: un rechazo devuelto al instante, una película y sus subtítulos en una llamada, la misma película reanudada #

El reproductor de vídeo cambia cinco cosas que su código puede ver. Un rechazo se devuelve al instante, como en el reproductor de sonidos (12.14): of_play(), of_play(source) y of_play_range devuelven -5, el motivo en of_get_last_error(), para una fuente vacía, una dirección http:// o un formato rechazado por su nombre (avi, wmv, flv) — y ya no lanzan ue_failed; la película en curso sigue. La propiedad is_source conserva su ue_failed: una propiedad no tiene código de retorno. La misma película no se recarga: of_play(source) o is_source sobre la película ya cargada la reanuda donde está (ue_resumed) en lugar de volver a empezarla; of_seek(0) la reinicia. Una búsqueda queda en el segmento de of_play_range, la del usuario como of_seek: Inicio lleva al comienzo del segmento, un clic más allá de su fin a su fin — antes, Inicio salía del extracto y un clic más allá detenía la película. Una entrada de la lista que no puede reproducirse lanza primero ue_source_changed, luego un solo ue_failed — llegaba antes, y dos veces. of_stop pasa a ser una función: no devolvía nada (subrutina), devuelve 0, o -2 cuando el componente no está creado — como of_stop del navegador 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

Lo que cambia sin pedir nada a su código: un marcador alcanzado por una búsqueda EN PAUSA ya no lanza ue_marker_reached (solo ue_seeked); Espacio y el botón Reproducir de un reproductor sin película ya no hacen nada (lanzaban ue_failed(REASON_NO_SOURCE)); el idioma de subtítulos elegido por el usuario pasa a la película siguiente de la lista; un cartel http:// se rechaza y is_poster se relee vacío; un is_subtitles rechazado se relee vacío; un archivo de subtítulos del equipo que no se encuentra lanza ue_subtitles_failed(REASON_NOT_FOUND); el menú de velocidad se maneja con el teclado y sus flechas ya no cambian el volumen; en pantalla completa la barra se muestra con el teclado; la posición recordada (ib_remember_position) ya no depende de cómo se escribe la ruta, y solo se guardan las 200 últimas películas (una posición de la 4.0 se relee una vez). El reproductor gana of_play(source, subtitles) (la película y SUS subtítulos: fijados antes de una segunda película, se iban con la primera), ib_forward_seek, of_watched_ms, of_watched_percent, ue_watched_completely e ib_skip_failed — vea la página del reproductor de vídeo.

La receta: nada se niega a compilar. Relea el código que esperaba ue_failed después de of_play para una dirección http://, una fuente vacía o un .avi: ahora comprueba el -5 de la llamada. Relea también un botón « Reproducir » que contaba con of_play(source) para volver a empezar: añada of_seek(0).

12.17 webbrowser: se pregunta por un gesto del usuario, una página de of_show_html no tiene dirección #

Con ib_veto_navigation = true, ue_navigating se pregunta ahora también para un gesto del usuario: una dirección escrita en la barra, Abrir vínculo del menú contextual, una ventana nueva abierta por un clic. En la 4.0 estos tres caminos no preguntaban. Solo una dirección asignada por su código no se pregunta nunca, y tampoco una redirección del servidor: para una lista de servidores que valga también para las redirecciones, asigne la nueva propiedad is_allowed_hosts.

La receta: nada se niega a compilar, un long ignorado compila. Un script de ue_navigating escrito para los vínculos del sitio ve ahora también las direcciones escritas por el usuario: si decide según la dirección, que compare su host, como el ejemplo de la página del componente — o confíe la lista a is_allowed_hosts. El código que leía as_url de ue_load_completed, o is_address, tras of_show_html recibe una cadena vacía.

12.18 toolbar: el clic derecho lleva su punto, una orden del código se anuncia #

La barra de herramientas se une a la biblioteca: el clic derecho de una herramienta da su punto de pantalla, como el de los árboles, las cuadrículas y la pestaña, y mover una barra con ii_band / ii_index dispara ue_bar_reordered como el gesto. Dos adiciones rechazan lo que aceptaban en silencio, y un atajo puesto donde nada vive ya no se registra. Gana además is_text en una barra, un nombre para cada herramienta y cada campo leído por un lector de pantalla, y un teclado que atraviesa los campos — ver la página de la barra de herramientas.

// 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 receta: nada se niega a compilar — un script de ue_item_rclicked conserva as_keys. Abra su menú en el punto al_x, al_y (páselo a of_show de un contextmenu). Compruebe que un script de ue_bar_reordered acepta también los movimientos que hace su código, pruebe el código de retorno de of_add_datepicker si la fecha viene de un campo regional, y ponga is_shortcut después de añadir la herramienta o la entrada.

12.19 El clic derecho de un elemento lleva su punto: buttonbar, breadcrumb, chartcartesian, statusbar #

Una sola regla para todo clic derecho sobre un elemento de la biblioteca: el evento recibe la clave (o la dirección) del elemento, luego al_x, al_y, el punto donde abrir un menú, en píxeles de pantalla — el puntero, o, con el teclado (tecla Menú, Mayús+F10), la esquina inferior izquierda del elemento (inferior derecha en una lectura de derecha a izquierda; el centro de una forma que no es un rectángulo: un punto de un gráfico). Un contextmenu de la biblioteca se abre allí tal cual: uo_menu.of_show(al_x, al_y). Tres eventos que no lo llevaban lo reciben; la barra de estado multiplicaba el suyo por la escala de la pantalla, y un menú abierto en ese punto caía lejos del puntero en una pantalla 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 receta: nada se niega a compilar — un script de estos eventos conserva sus argumentos. Abra su menú en el punto al_x, al_y (páselo a of_show de un contextmenu); un menú PowerBuilder conserva PopMenu(PointerX(), PointerY()) de su ventana. Un script que corregía él mismo la escala de las coordenadas de ue_panel_rclicked ya no debe hacerlo.

12.20 La base: el error de un componente es el suyo, cada verbo devuelve un código #

Cinco cambios afectan a toda la biblioteca, o a toda una familia de componentes. Solo uno se niega a compilar: is_last_error de un componente no visual, ahora 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 receta: el compilador muestra cada .is_last_error que hay que sustituir por .of_get_last_error(). Una llamada a of_stop, of_close u of_reset escrita como instrucción sigue compilando. Un script que leía of_get_last_error() de un componente para conocer el fallo de otra llamada (un export de la DLL llamado directamente, otro componente) lee ahora el motivo de ese componente, o nada: pregúnteselo al que falló.

Añadido, nada que rehacer: is_accessible_name e is_accessible_description en todos los componentes visuales — el nombre y la descripción que dice un lector de pantalla (3.4); of_from_datastore de un DataWindow o de un DataWindowChild en crosstab y datagrid, como en los demás componentes ligados a datos; la forma completa de of_insert_command (commandpalette), que toma la explicación, el atajo y las palabras clave como of_add_command, con una posición en long.

← Migrar de la 3.0 a la 4.0 · Índice · Notas de la versión →