statictext — u_pbt_statictext #

← Riferimento dei componenti · Sommario della guida

Blocco di testo formattato: tag, allineamenti, collegamenti e azioni cliccabili, aspetto da intestazione, modalità scorrimento (marquee) e area di rilascio dei file.

▶ Vederlo dal vivo — Applicazione dimostrativa, riquadro Statictext: l'anteprima, il codice che lo produce e questa pagina, affiancati.

In breve #

Avvio rapido #

// event open della finestra
uo_text.is_text = "Benvenuto in [b][accent]PBToolboxAI[/accent][/b][br]" &
                   + "Consulti la [hyperlink=https://pbtoolboxai.net]documentazione[/hyperlink]."
uo_text.is_align = uo_text.ALIGN_CENTER
uo_text.is_valign = uo_text.VALIGN_CENTER

Il testo accetta il testo formattato con tag: è questo il componente che ne trae il massimo vantaggio, poiché è l'unico a rendere cliccabili le aree [action=…] (un [hyperlink=…] si apre ovunque).

Costanti #

start ed end sono logici: seguono il senso di scrittura (Lingua e RTL). I valori fisici left e right restano accettati come alias.

Proprietà #

Testo e formattazione #

Aspetto del blocco (look da « intestazione ») #

Modalità scorrimento (marquee) #

Interazioni opzionali #

Metodi #

Event #

Esempi #

Un'intestazione di sezione #

Sfondo pieno, testo bianco centrato e altezza adattata al contenuto: il blocco si legge come una vera barra del titolo.

// Congelare la visualizzazione mentre si imposta tutto
uo_header.of_set_redraw(/*on*/ false)

// Il titolo, centrato
uo_header.is_text  = "[b]Cruscotto delle vendite"
uo_header.is_align = uo_header.ALIGN_CENTER

// Sfondo pieno e testo bianco leggibile
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

// Il blocco aderisce al suo contenuto : si legge come una barra del titolo
uo_header.ib_auto_height = true

// Tutto viene disegnato in una volta
uo_header.of_set_redraw(/*on*/ true)

// event ue_auto_height di uo_header
of_reposition_below_header(al_height)   // sposta il contenuto sotto l'intestazione

Testo formattato con collegamento e azione #

// Un link a una pagina web e un'azione gestita dalla Sua applicazione (ue_action)
uo_text.is_text = "La Sua licenza scade il [b]31/12[/b]. " &
                   + "[hyperlink=https://pbtoolboxai.net]Maggiori informazioni[/hyperlink] " &
                   + "oppure [action=renew]la rinnovi subito[/action]."

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

ue_hyperlink è riservato agli URL (il browser si apre da solo); [action=id] è la scelta giusta quando il clic deve restare dentro la Sua applicazione. La variante [invisibleaction=id] attiva lo stesso ue_action senza l'aspetto di un collegamento.

Un blocco comprimibile #

// Due sezioni comprimibili : la seconda parte compressa
uo_recap.is_text = "[b]Ordine 2026-0148[/b][br]" &
                   + "[foldarea:[b]Consegna[/b]]Spedito il 12/07, entro 48 ore.[/foldarea]" &
                   + "[foldarea-closed:[i]Note legali[/i]]Reso accettato entro 14 giorni.[/foldarea]"

// Il blocco si restringe quando una sezione viene compressa
uo_recap.ib_auto_height = true

Un [foldarea:Titolo] aggiunge un'intestazione cliccabile sopra il proprio contenuto: il lettore comprime la sezione con un clic e il marcatore passa da − a +. [foldarea-closed:Titolo] produce lo stesso blocco, compresso fin dalla visualizzazione. I blocchi si annidano e la compressione non emette alcun event: è una questione di lettura, non di codice. Se ib_auto_height è attivo, l'altezza viene notificata di nuovo a ogni compressione. Il titolo è testo con tag: [foldarea:[b][accent]Ordine 2026-0148[/accent][/b]] rende il proprio in grassetto e con il colore d'accento.

Un banner scorrevole #

// Il messaggio del banner
uo_banner.is_text = "[b]Informazione[/b] -- chiusura straordinaria del servizio venerdì 12."

// Modalita scorrimento, stile notiziario
uo_banner.ib_marquee = true
uo_banner.ii_marquee_speed = 90        // pixel al secondo
uo_banner.is_marquee_direction = uo_banner.MARQUEE_START

Lo scorrimento va in ciclo senza tempi morti. Per fermarlo, riporti ib_marquee a false: il testo riprende la sua impaginazione normale.

Una volta impostato ib_track_cycle = true, a ogni passaggio completo del testo viene attivato l'event ue_cycle — pratico per far ruotare più messaggi:

// In ue_cycle del banner : passare al messaggio successivo
ii_message = Mod(ii_message, UpperBound(is_messages)) + 1
uo_banner.is_text = is_messages[ii_message]

Un'area di rilascio dei file #

// Accettare i file trascinati da Esplora risorse di Windows
uo_zone.ib_allow_drop = true

// Cio che la zona mostra, centrato
uo_zone.is_text = "[size=32][accent][b]Rilasci qui i Suoi file[/b][/accent][/size][br][br]" &
                  + "Trascini uno o più file da Esplora risorse di Windows."
uo_zone.is_align  = uo_zone.ALIGN_CENTER
uo_zone.is_valign = uo_zone.VALIGN_CENTER

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

// Ogni file rilasciato, uno dopo l'altro
for li = 1 to UpperBound(as_files)
    of_import(as_files[li])       // as_files[li] = percorso COMPLETO del file
next

// event ue_drag_enter di uo_zone : segnalare la destinazione durante il passaggio
uo_zone.il_border_color = RGB(/*red*/ 21, /*green*/ 101, /*blue*/ 192)
uo_zone.ii_border_width = 2

I percorsi ricevuti sono completi: può passarli direttamente a FileOpen o alla Sua routine di importazione.

Un'etichetta che si comporta come un pulsante #

// Un testo che si comporta come un pulsante-link
uo_link.is_text = "Seleziona tutto"
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       // reagisce al passaggio del mouse come un pulsante

// event ue_clicked di uo_link
of_select_all()

Un registro scritto riga per riga #

Ogni chiamata invia solo la riga aggiunta; ib_follow_end tiene l'ultima in vista finché il lettore non risale.

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

Un'etichetta larga quanto il suo testo #

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

Buone pratiche #

• Un testo senza tag non comporta alcun costo aggiuntivo: non esiti a sostituire sistematicamente i Suoi statictext di PowerBuilder, anche per il testo semplice.
• Preferisca is_align = uo.ALIGN_START a "left": la Sua schermata resterà corretta se l'applicazione passa alla scrittura da destra a sinistra.
• ib_selectable resta disattivato per impostazione predefinita, come un'etichetta. Lo attivi solo dove la copia ha senso (numero di pratica, messaggio di errore tecnico).
• Per un'intestazione, combini il_back_color + ii_padding + ib_auto_height: il blocco si dimensiona da solo quando il testo cambia lunghezza.
• Attivi ib_track_mouse solo se scrive davvero il codice di ue_mouse_enter / ue_mouse_leave.
• Chiami of_reset() prima di riutilizzare un blocco per un altro contenuto: senza di esso, uno sfondo, un bordo o la modalità scorrimento precedenti restano attivi.

Ereditato dalla base comune #

Questi membri esistono su tutti i componenti visivi — non sono propri di questo. Sono descritti una sola volta, nei capitoli trasversali; questa tabella dice solo dove leggerli.

Due aiuti non sono ereditati: of_icon e of_escape_markup vivono su n_pbt_utils. Ne dichiari uno — n_pbt_utils lnv_utils, niente da creare — e li chiami su di esso.

← Riferimento dei componenti · Sommario della guida