statictext — u_pbt_statictext #

← Component reference · Guide contents

Rich text block: markup, alignments, clickable links and actions, header look, scrolling mode (marquee) and file drop zone.

▶ See it live — Demo application, Statictext tile: the preview, the code behind it and this page, side by side.

At a glance #

Quick start #

// window open event
uo_texte.is_text = "Welcome to [b][accent]PBToolboxAI[/accent][/b][br]" &
                   + "See the [hyperlink=https://pbtoolboxai.net]documentation[/hyperlink]."
uo_texte.is_align = uo_texte.ALIGN_CENTER
uo_texte.is_valign = uo_texte.VALIGN_CENTER

The text accepts rich text markup: this is the component that makes the most of it, since it is the only one that makes [hyperlink=…] and [action=…] areas genuinely clickable.

Constants #

start and end are logical: they follow the writing direction (Language and RTL). The physical values left and right are still accepted as aliases.

Properties #

Text and formatting #

Block look (the "header" look) #

Scrolling mode (marquee) #

Optional interactions #

Methods #

Events #

Examples #

A section header #

Solid background, centered white text and a height fitted to the content: the block reads like a real title bar.

uo_entete.of_set_redraw(false)

uo_entete.is_text  = "[b]Sales dashboard"
uo_entete.is_align = uo_entete.ALIGN_CENTER

// Solid background and readable white text
uo_entete.il_back_color = RGB(/*red*/ 60, /*green*/ 110, /*blue*/ 190)
uo_entete.il_text_color = RGB(/*red*/ 255, /*green*/ 255, /*blue*/ 255)
uo_entete.ii_padding = 14

// The block hugs its content : it reads like a title bar
uo_entete.ib_auto_height = true

uo_entete.of_set_redraw(true)

// ue_auto_height event of uo_entete
of_repositionner_sous_entete(al_height)   // moves the content below the header

Rich text with a link and an action #

uo_texte.is_text = "Your license expires on [b]12/31[/b]. " &
                   + "[hyperlink=https://pbtoolboxai.net]Learn more[/hyperlink] " &
                   + "or [action=renew]renew it now[/action]."

// ue_action event of uo_texte : (string as_id)
choose case as_id
    case "renew" ; of_ouvrir_renouvellement()
end choose

ue_hyperlink is meant for URLs (the browser opens on its own); [action=id] is the right choice when the click has to stay inside your application. The [invisibleaction=id] variant raises the same ue_action without looking like a link.

A collapsible block #

uo_recap.is_text = "[b]Order 2026-0148[/b][br]" &
                   + "[foldarea:[b]Delivery[/b]]Shipped on 12/07, within 48 hours.[/foldarea]" &
                   + "[foldarea-closed:[i]Legal notice[/i]]Returns accepted within 14 days.[/foldarea]"

uo_recap.ib_auto_height = true   // the block shrinks when a section is folded

A [foldarea:Title] adds a clickable header above its content: the reader folds the section with a click, and the marker turns from − into +. [foldarea-closed:Title] produces the same block, folded from the start. Blocks nest, and folding raises no event: it is a reading matter, not a coding one. When ib_auto_height is on, the height is reported again on every fold. The title is markup: [foldarea:[b][accent]Order 2026-0148[/accent][/b]] makes its own bold and accent-colored.

A scrolling banner #

uo_bandeau.is_text = "[b]Notice[/b] -- the service will be closed on Friday the 12th."

// Scrolling mode, news-ticker style
uo_bandeau.ib_marquee = true
uo_bandeau.ii_marquee_speed = 90        // pixels per second
uo_bandeau.is_marquee_direction = uo_bandeau.MARQUEE_START

The scrolling loops with no dead time. To stop it, set ib_marquee back to false: the text returns to its normal layout.

On every full pass of the text, the ue_cycle event is raised — handy for rotating several messages:

// In ue_cycle of the banner : move on to the next message
ii_message = Mod(ii_message, UpperBound(is_messages)) + 1
uo_bandeau.is_text = is_messages[ii_message]

A file drop zone #

// Accept files dragged from Windows Explorer
uo_zone.ib_allow_drop = true

uo_zone.is_text = "[size=32][accent][b]Drop your files here[/b][/accent][/size][br][br]" &
                  + "Drag one or more files from Windows Explorer."
uo_zone.is_align  = uo_zone.ALIGN_CENTER
uo_zone.is_valign = uo_zone.VALIGN_CENTER

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

for li = 1 to UpperBound(as_files)
    of_importer(as_files[li])       // as_files[li] = FULL path of the file
next

// ue_drag_enter event of uo_zone : highlight the target while hovering
uo_zone.il_border_color = RGB(/*red*/ 21, /*green*/ 101, /*blue*/ 192)
uo_zone.ii_border_width = 2

The paths you receive are full paths: you can pass them straight to FileOpen or to your own import routine.

A label that behaves like a button #

uo_lien.is_text = "Select all"
uo_lien.il_text_color = RGB(/*red*/ 21, /*green*/ 101, /*blue*/ 192)
uo_lien.ii_padding = 8
uo_lien.ii_corner_radius = 6
uo_lien.ib_hover_effect = true       // reacts to hover like a button

// ue_clicked event of uo_lien
of_tout_selectionner()

Best practices #

• Text without markup costs nothing extra: feel free to replace your PowerBuilder statictext controls systematically, even for plain text.
• Prefer is_align = uo.ALIGN_START over "left": your screen will still be correct if the application switches to right-to-left writing.
• ib_selectable stays off by default, like a label. Turn it on only where copying makes sense (case number, technical error message).
• For a header, combine il_back_color + ii_padding + ib_auto_height: the block sizes itself when the text changes length.
• Only turn ib_track_mouse on if you really script ue_mouse_enter / ue_mouse_leave.
• Call of_reset() before reusing a block for different content: otherwise a previous background, border or scrolling mode stays in place.

← Component reference · Guide contents