statictext — u_pbt_statictext #

← Référence des composants · Sommaire du guide

Bloc de texte riche : balisage, alignements, liens et actions cliquables, allure d'en-tête, mode défilant (marquee) et zone de dépôt de fichiers.

▶ Le voir en vrai — Application de démonstration, tuile Statictext : l'aperçu, le code qui le produit et cette page, côte à côte.

En bref #

Démarrage rapide #

// event open de la fenetre
uo_text.is_text = "Bienvenue sur [b][accent]PBToolboxAI[/accent][/b][br]" &
                   + "Consultez la [hyperlink=https://pbtoolboxai.net]documentation[/hyperlink]."
uo_text.is_align = uo_text.ALIGN_CENTER
uo_text.is_valign = uo_text.VALIGN_CENTER

Le texte accepte le balisage riche : c'est ce composant qui en tire le meilleur parti, puisqu'il est le seul à rendre les zones [action=…] cliquables (un [hyperlink=…] s'ouvre partout).

Constantes #

start et end sont logiques : ils suivent le sens d'écriture (Langue et RTL). Les valeurs physiques left et right restent acceptées comme alias.

Propriétés #

Texte et mise en forme #

Allure de bloc (look « en-tête ») #

Mode défilant (marquee) #

Interactions optionnelles #

Méthodes #

Événements #

Exemples #

Un en-tête de section #

Fond plein, texte blanc centré et hauteur ajustée au contenu : le bloc se lit comme une vraie barre de titre.

// Geler l'affichage le temps de tout poser
uo_header.of_set_redraw(/*on*/ false)

// Le titre, centre
uo_header.is_text  = "[b]Tableau de bord des ventes"
uo_header.is_align = uo_header.ALIGN_CENTER

// Fond plein et texte blanc lisible
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

// Le bloc se colle a son contenu : il se lit comme une barre de titre
uo_header.ib_auto_height = true

// Tout se dessine en une fois
uo_header.of_set_redraw(/*on*/ true)

// event ue_auto_height de uo_header
of_reposition_below_header(al_height)   // decale le contenu sous l'en-tete

Texte riche avec lien et action #

// Un lien vers une page web, et une action que votre application traite (ue_action)
uo_text.is_text = "Votre licence expire le [b]31/12[/b]. " &
                   + "[hyperlink=https://pbtoolboxai.net]En savoir plus[/hyperlink] " &
                   + "ou [action=renew]la renouveler maintenant[/action]."

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

ue_hyperlink est réservé aux URL (le navigateur s'ouvre tout seul) ; [action=id] est le bon choix quand le clic doit rester dans votre application. La variante [invisibleaction=id] déclenche le même ue_action sans l'apparence d'un lien.

Un bloc repliable #

// Deux sections repliables : la seconde commence repliee
uo_recap.is_text = "[b]Commande 2026-0148[/b][br]" &
                   + "[foldarea:[b]Livraison[/b]]Expedie le 12/07, sous 48 heures.[/foldarea]" &
                   + "[foldarea-closed:[i]Mentions legales[/i]]Retour accepte sous 14 jours.[/foldarea]"

// Le bloc se retracte quand une section est repliee
uo_recap.ib_auto_height = true

Un [foldarea:Titre] ajoute un en-tête cliquable au-dessus de son contenu : le lecteur replie la section d'un clic, et le marqueur passe de − à +. [foldarea-closed:Titre] produit le même bloc, replié dès l'affichage. Les blocs s'imbriquent, et le repli ne remonte aucun event : c'est une affaire de lecture, pas de code. Si ib_auto_height est actif, la hauteur est renotifiée à chaque repli. Le titre est du texte à balises : [foldarea:[b][accent]Commande 2026-0148[/accent][/b]] met le sien en gras et à la couleur d'accent.

Un bandeau défilant #

// Le message du bandeau
uo_banner.is_text = "[b]Information[/b] -- fermeture exceptionnelle du service le vendredi 12."

// Mode defilant, facon fil d'actualite
uo_banner.ib_marquee = true
uo_banner.ii_marquee_speed = 90        // pixels par seconde
uo_banner.is_marquee_direction = uo_banner.MARQUEE_START

Le défilement boucle sans temps mort. Pour l'arrêter, repassez ib_marquee à false : le texte reprend sa mise en page normale.

Une fois ib_track_cycle = true posé, l'événement ue_cycle est déclenché à chaque passage complet du texte — pratique pour faire tourner plusieurs messages :

// Dans ue_cycle du bandeau : passer au message suivant
ii_message = Mod(ii_message, UpperBound(is_messages)) + 1
uo_banner.is_text = is_messages[ii_message]

Une zone de dépôt de fichiers #

// Accepter les fichiers glisses depuis l'Explorateur Windows
uo_zone.ib_allow_drop = true

// Ce que la zone affiche, centre
uo_zone.is_text = "[size=32][accent][b]Deposez vos fichiers ici[/b][/accent][/size][br][br]" &
                  + "Glissez un ou plusieurs fichiers depuis l'Explorateur 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

// Chaque fichier depose, l'un apres l'autre
for li = 1 to UpperBound(as_files)
    of_import(as_files[li])       // as_files[li] = chemin COMPLET du fichier
next

// event ue_drag_enter de uo_zone : signaler la cible pendant le survol
uo_zone.il_border_color = RGB(/*red*/ 21, /*green*/ 101, /*blue*/ 192)
uo_zone.ii_border_width = 2

Les chemins reçus sont complets : vous pouvez les passer directement à FileOpen ou à votre routine d'import.

Un libellé qui se comporte comme un bouton #

// Un texte qui se comporte comme un bouton-lien
uo_link.is_text = "Tout selectionner"
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       // reagit au survol comme un bouton

// event ue_clicked de uo_link
of_select_all()

Un journal qui s'écrit ligne à ligne #

Chaque appel n'envoie que la ligne ajoutée ; ib_follow_end garde la dernière en vue tant que le lecteur ne remonte pas.

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

Une étiquette à la largeur de son texte #

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

Bonnes pratiques #

• Un texte sans balise n'a aucun surcoût : n'hésitez pas à remplacer systématiquement vos statictext PowerBuilder, même pour du texte brut.
• Préférez is_align = uo.ALIGN_START à "left" : votre écran restera correct si l'application passe en écriture de droite à gauche.
• ib_selectable reste coupé par défaut, comme un libellé. Ne l'activez que là où la copie a du sens (numéro de dossier, message d'erreur technique).
• Pour un en-tête, combinez il_back_color + ii_padding + ib_auto_height : le bloc se dimensionne seul quand le texte change de longueur.
• N'activez ib_track_mouse que si vous scriptez réellement ue_mouse_enter / ue_mouse_leave.
• Appelez of_reset() avant de réutiliser un bloc pour un autre contenu : sans cela, un fond, une bordure ou le mode défilant précédents restent en place.

Hérité du socle commun #

Ces membres existent sur tous les composants visuels — ils ne sont pas propres à celui-ci. Ils sont détaillés une seule fois, dans les chapitres transverses ; cette table dit seulement où les lire.

Deux aides ne sont pas héritées : of_icon et of_escape_markup vivent sur n_pbt_utils. Déclarez-en une — n_pbt_utils lnv_utils, rien à créer — et appelez-les dessus.

← Référence des composants · Sommaire du guide