statictext — u_pbt_statictext #

← Referencia de componentes · Índice de la guía

Bloque de texto enriquecido: etiquetas, alineaciones, enlaces y acciones en los que se puede hacer clic, aspecto de encabezado, modo desplazable (marquee) y zona para soltar ficheros.

▶ Verlo en vivo — Aplicación de demostración, mosaico Statictext: la vista previa, el código que lo genera y esta página, uno al lado del otro.

De un vistazo #

Inicio rápido #

// event open de la ventana
uo_text.is_text = "Bienvenido a [b][accent]PBToolboxAI[/accent][/b][br]" &
                   + "Consulte la [hyperlink=https://pbtoolboxai.net]documentación[/hyperlink]."
uo_text.is_align = uo_text.ALIGN_CENTER
uo_text.is_valign = uo_text.VALIGN_CENTER

El texto admite el texto enriquecido con etiquetas: es este componente el que mejor partido le saca, ya que es el único que hace pulsables las zonas [action=…] (un [hyperlink=…] se abre en todas partes).

Constantes #

start y end son lógicos: siguen el sentido de escritura (Idioma y RTL). Los valores físicos left y right se siguen aceptando como alias.

Propiedades #

Texto y formato #

Aspecto de bloque (aire de «encabezado») #

Modo desplazable (marquee) #

Interacciones opcionales #

Métodos #

Eventos #

Ejemplos #

Un encabezado de sección #

Fondo liso, texto blanco centrado y altura ajustada al contenido: el bloque se lee como una auténtica barra de título.

// Congelar la visualizacion mientras se configura todo
uo_header.of_set_redraw(/*on*/ false)

// El titulo, centrado
uo_header.is_text  = "[b]Cuadro de mando de ventas"
uo_header.is_align = uo_header.ALIGN_CENTER

// Fondo liso y texto blanco legible
uo_header.il_back_color = RGB(/*red*/ 60, /*green*/ 110, /*blue*/ 190)
uo_header.il_text_color = RGB(/*red*/ 255, /*green*/ 255, /*blue*/ 255)
uo_header.ii_padding = 14

// El bloque se cine a su contenido : se lee como una barra de titulo
uo_header.ib_auto_height = true

// Todo se dibuja de una vez
uo_header.of_set_redraw(/*on*/ true)

// event ue_auto_height de uo_header
of_reposition_below_header(al_height)   // desplaza el contenido bajo el encabezado

Texto enriquecido con enlace y acción #

// Un enlace a una pagina web y una accion que su aplicacion trata (ue_action)
uo_text.is_text = "Su licencia caduca el [b]31/12[/b]. " &
                   + "[hyperlink=https://pbtoolboxai.net]Más información[/hyperlink] " &
                   + "o [action=renew]renuévela ahora[/action]."

// event ue_action de uo_text : (string as_key)
choose case as_key
    case "renew" ; of_open_renewal()
end choose

ue_hyperlink está reservado a las URL (el navegador se abre solo); [action=id] es la opción adecuada cuando el clic debe permanecer dentro de su aplicación. La variante [invisibleaction=id] activa el mismo ue_action sin la apariencia de un enlace.

Un bloque plegable #

// Dos secciones plegables : la segunda empieza plegada
uo_recap.is_text = "[b]Pedido 2026-0148[/b][br]" &
                   + "[foldarea:[b]Entrega[/b]]Enviado el 12/07, en 48 horas.[/foldarea]" &
                   + "[foldarea-closed:[i]Aviso legal[/i]]Devolucion aceptada en 14 dias.[/foldarea]"

// El bloque se encoge cuando se pliega una seccion
uo_recap.ib_auto_height = true

Un [foldarea:Título] añade un encabezado en el que se puede hacer clic sobre su contenido: el lector pliega la sección con un clic y el marcador pasa de − a +. [foldarea-closed:Título] produce el mismo bloque, plegado desde el principio. Los bloques se anidan y el pliegue no emite ningún evento: es una cuestión de lectura, no de código. Si ib_auto_height está activo, la altura se vuelve a notificar en cada pliegue. El título es texto con etiquetas: [foldarea:[b][accent]Pedido 2026-0148[/accent][/b]] pone el suyo en negrita y con el color de acento.

Una banda desplazable #

// El mensaje de la banda
uo_banner.is_text = "[b]Información[/b] -- cierre excepcional del servicio el viernes 12."

// Modo desplazable, al estilo de un teletipo de noticias
uo_banner.ib_marquee = true
uo_banner.ii_marquee_speed = 90        // pixeles por segundo
uo_banner.is_marquee_direction = uo_banner.MARQUEE_START

El desplazamiento se repite sin tiempos muertos. Para detenerlo, vuelva a poner ib_marquee en false: el texto recupera su disposición normal.

Una vez puesto ib_track_cycle = true, en cada pasada completa del texto se activa el evento ue_cycle — práctico para ir rotando varios mensajes:

// En ue_cycle de la banda : pasar al mensaje siguiente
ii_message = Mod(ii_message, UpperBound(is_messages)) + 1
uo_banner.is_text = is_messages[ii_message]

Una zona para soltar ficheros #

// Aceptar los ficheros arrastrados desde el Explorador de Windows
uo_zone.ib_allow_drop = true

// Lo que muestra la zona, centrado
uo_zone.is_text = "[size=32][accent][b]Suelte aquí sus ficheros[/b][/accent][/size][br][br]" &
                  + "Arrastre uno o varios ficheros desde el Explorador de Windows."
uo_zone.is_align  = uo_zone.ALIGN_CENTER
uo_zone.is_valign = uo_zone.VALIGN_CENTER

// event ue_drop_files de uo_zone : (string as_files[])
integer li

// Cada fichero soltado, uno tras otro
for li = 1 to UpperBound(as_files)
    of_import(as_files[li])       // as_files[li] = ruta COMPLETA del fichero
next

// event ue_drag_enter de uo_zone : senalar el destino al pasar el cursor
uo_zone.il_border_color = RGB(/*red*/ 21, /*green*/ 101, /*blue*/ 192)
uo_zone.ii_border_width = 2

Las rutas recibidas son completas: puede pasarlas directamente a FileOpen o a su rutina de importación.

Una etiqueta que se comporta como un botón #

// Un texto que se comporta como un boton-enlace
uo_link.is_text = "Seleccionar todo"
uo_link.il_text_color = RGB(/*red*/ 21, /*green*/ 101, /*blue*/ 192)
uo_link.ii_padding = 8
uo_link.ii_corner_radius = 6
uo_link.ib_hover_effect = true       // reacciona al paso del cursor como un boton

// event ue_clicked de uo_link
of_select_all()

Un registro escrito línea a línea #

Cada llamada envía solo la línea añadida; ib_follow_end mantiene la última a la vista mientras el lector no suba.

// Once, when the window opens
uo_log.ib_follow_end = true
uo_log.is_text = "[b]Import[/b]"

// For every row imported : one line, sent alone
uo_log.of_append_text(/*markup*/ "Row " + String(ll_row) + " [color=#2e7d32]imported[/color]")

Una etiqueta tan ancha como su texto #

// A status chip : background, rounded corners, and the width of its text
uo_status.is_text = "[b]Status :[/b] connected"
uo_status.il_back_color = RGB(/*red*/ 232, /*green*/ 245, /*blue*/ 233)
uo_status.ii_corner_radius = 12
uo_status.ib_auto_width = true

Buenas prácticas #

• Un texto sin etiquetas no tiene ningún coste añadido: no dude en sustituir sistemáticamente sus statictext de PowerBuilder, incluso para texto sin formato.
• Prefiera is_align = uo.ALIGN_START a "left": su pantalla seguirá siendo correcta si la aplicación pasa a escritura de derecha a izquierda.
• ib_selectable permanece desactivado de forma predeterminada, como una etiqueta. Actívelo solo allí donde copiar tenga sentido (número de expediente, mensaje de error técnico).
• Para un encabezado, combine il_back_color + ii_padding + ib_auto_height: el bloque se dimensiona solo cuando el texto cambia de longitud.
• Active ib_track_mouse únicamente si realmente programa ue_mouse_enter / ue_mouse_leave.
• Llame a of_reset() antes de reutilizar un bloque para otro contenido: de lo contrario, permanecerán en su sitio el fondo, el borde o el modo desplazable anteriores.

Heredado de la base común #

Estos miembros existen en todos los componentes visuales — no son propios de este. Se detallan una sola vez, en los capítulos transversales; esta tabla solo dice dónde leerlos.

Dos ayudas no se heredan: of_icon y of_escape_markup viven en n_pbt_utils. Declare uno — n_pbt_utils lnv_utils, nada que crear — y llámelas sobre él.

← Referencia de componentes · Índice de la guía