statictext — u_pbt_statictext #

← Komponentenreferenz · Inhalt des Handbuchs

Rich-Text-Block: Auszeichnung, Ausrichtungen, klickbare Links und Aktionen, Kopfzeilen-Optik, Laufschriftmodus (Marquee) und Ablagebereich für Dateien.

▶ Live ansehen — Demoanwendung, Kachel Statictext: die Vorschau, der zugehörige Code und diese Seite, nebeneinander.

Auf einen Blick #

Schnellstart #

// open-Event des Fensters
uo_text.is_text = "Willkommen bei [b][accent]PBToolboxAI[/accent][/b][br]" &
                   + "Lesen Sie die [hyperlink=https://pbtoolboxai.net]Dokumentation[/hyperlink]."
uo_text.is_align = uo_text.ALIGN_CENTER
uo_text.is_valign = uo_text.VALIGN_CENTER

Der Text akzeptiert die Rich-Text-Auszeichnung: Diese Komponente holt am meisten daraus heraus — ihre [action=…]-Bereiche lösen ue_action aus und sind auch per Tastatur erreichbar (die Meldungsbox macht sie ebenfalls klickbar; ein [hyperlink=…] öffnet sich überall).

Konstanten #

start und end sind logisch: Sie folgen der Schreibrichtung (Sprache und RTL). Die physischen Werte left und right werden weiterhin als Aliasnamen akzeptiert.

Eigenschaften #

Text und Formatierung #

Blockoptik (die „Kopfzeilen“-Optik) #

Laufschriftmodus (Marquee) #

Optionale Interaktionen #

Methoden #

Events #

Beispiele #

Eine Abschnittskopfzeile #

Vollflächiger Hintergrund, zentrierter weißer Text und eine an den Inhalt angepasste Höhe: Der Block liest sich wie eine echte Titelleiste.

// Die Anzeige einfrieren, solange alles gesetzt wird
uo_header.of_set_redraw(/*on*/ false)

// Der Titel, zentriert
uo_header.is_text  = "[b]Verkaufs-Dashboard"
uo_header.is_align = uo_header.ALIGN_CENTER

// Vollflaechiger Hintergrund und gut lesbarer weisser Text
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

// Der Block schmiegt sich an seinen Inhalt : er liest sich wie eine Titelleiste
uo_header.ib_auto_height = true

// Alles wird auf einmal gezeichnet
uo_header.of_set_redraw(/*on*/ true)

// ue_auto_height-Event von uo_header
of_reposition_below_header(al_height)   // verschiebt den Inhalt unter die Kopfzeile

Rich-Text mit Link und Aktion #

// Ein Link auf eine Webseite und eine Aktion, die Ihre Anwendung behandelt (ue_action)
uo_text.is_text = "Ihre Lizenz läuft am [b]31.12.[/b] ab. " &
                   + "[hyperlink=https://pbtoolboxai.net]Mehr erfahren[/hyperlink] " &
                   + "oder [action=renew]jetzt verlängern[/action]."

// ue_action-Event von uo_text : (string as_key)
choose case as_key
    case "renew" ; of_open_renewal()
end choose

ue_hyperlink ist für URLs gedacht (der Browser öffnet sich von selbst); [action=id] ist die richtige Wahl, wenn der Klick innerhalb Ihrer Anwendung bleiben soll. Die Variante [invisibleaction=id] löst dasselbe ue_action aus, ohne wie ein Link auszusehen.

Ein einklappbarer Block #

// Zwei einklappbare Abschnitte : der zweite beginnt eingeklappt
uo_recap.is_text = "[b]Bestellung 2026-0148[/b][br]" &
                   + "[foldarea:[b]Lieferung[/b]]Am 12.07. versandt, innerhalb von 48 Stunden.[/foldarea]" &
                   + "[foldarea-closed:[i]Rechtliche Hinweise[/i]]Ruckgabe innerhalb von 14 Tagen moglich.[/foldarea]"

// Der Block schrumpft, wenn ein Abschnitt eingeklappt wird
uo_recap.ib_auto_height = true

Ein [foldarea:Titel] setzt eine anklickbare Kopfzeile über seinen Inhalt: Der Leser klappt den Abschnitt mit einem Klick ein, und der Marker wechselt von − zu +. [foldarea-closed:Titel] erzeugt denselben Block, von Anfang an eingeklappt. Blöcke lassen sich verschachteln, und das Einklappen löst kein Event aus: Es ist eine Sache des Lesens, nicht des Codes. Ist ib_auto_height aktiv, wird die Höhe bei jedem Ein- und Ausklappen erneut gemeldet. Der Titel ist Auszeichnungstext: [foldarea:[b][accent]Auftrag 2026-0148[/accent][/b]] setzt seinen eigenen fett und in Akzentfarbe.

Ein laufendes Band #

// Die Meldung des Bandes
uo_banner.is_text = "[b]Hinweis[/b] -- der Dienst bleibt am Freitag, dem 12., geschlossen."

// Laufschriftmodus, wie ein Nachrichtenticker
uo_banner.ib_marquee = true
uo_banner.ii_marquee_speed = 90        // Pixel pro Sekunde
uo_banner.is_marquee_direction = uo_banner.MARQUEE_START

Der Lauf wiederholt sich ohne Leerlauf. Zum Anhalten setzen Sie ib_marquee wieder auf false: Der Text nimmt sein normales Layout wieder an.

Sobald ib_track_cycle = true gesetzt ist, wird bei jedem vollständigen Durchlauf des Textes das Event ue_cycle ausgelöst — praktisch, um mehrere Meldungen abwechselnd anzuzeigen:

// In ue_cycle des Bandes : zur naechsten Meldung wechseln
ii_message = Mod(ii_message, UpperBound(is_messages)) + 1
uo_banner.is_text = is_messages[ii_message]

Ein Ablagebereich für Dateien #

// Aus dem Windows-Explorer gezogene Dateien annehmen
uo_zone.ib_allow_drop = true

// Was die Zone anzeigt, zentriert
uo_zone.is_text = "[size=32][accent][b]Dateien hier ablegen[/b][/accent][/size][br][br]" &
                  + "Ziehen Sie eine oder mehrere Dateien aus dem Windows-Explorer."
uo_zone.is_align  = uo_zone.ALIGN_CENTER
uo_zone.is_valign = uo_zone.VALIGN_CENTER

// ue_drop_files-Event von uo_zone : (string as_files[])
// Local variables
integer li

// Das Ablegen ist vorbei : die Zone sieht wieder normal aus
uo_zone.ii_border_width = 0

// Jede abgelegte Datei, eine nach der anderen
for li = 1 to UpperBound(as_files)
    of_import(as_files[li])       // as_files[li] = VOLLSTAENDIGER Pfad der Datei
next

// ue_drag_enter-Event von uo_zone : das Ziel waehrend des Ueberfahrens hervorheben
uo_zone.il_border_color = RGB(/*red*/ 21, /*green*/ 101, /*blue*/ 192)
uo_zone.ii_border_width = 2

// ue_drag_leave-Event von uo_zone : das Ziehen ist weg, die Zone sieht wieder normal aus
uo_zone.ii_border_width = 0

Die empfangenen Pfade sind vollständig: Sie können sie direkt an FileOpen oder an Ihre eigene Importroutine übergeben.

Eine Beschriftung, die sich wie eine Schaltfläche verhält #

// Ein Text, der sich wie eine Link-Schaltflaeche verhaelt
uo_link.is_text = "Alles auswählen"
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       // reagiert auf den Mauszeiger wie eine Schaltflaeche

// ue_clicked-Event von uo_link
of_select_all()

Ein Protokoll, Zeile für Zeile geschrieben #

Jeder Aufruf sendet nur die hinzugefügte Zeile; ib_follow_end hält die letzte sichtbar, solange der Leser nicht nach oben scrollt, und il_max_log_lines behält nur die neuesten.

// Local variables
long ll_row

// Once, when the window opens : the view follows the end, the 500 newest lines are kept
uo_log.ib_follow_end = true
uo_log.il_max_log_lines = 500
uo_log.is_text = "[b]Import[/b]"

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

Ein Etikett so breit wie sein Text #

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

Eine Feldbeschriftung wie in PowerBuilder #

Eine aus einem PowerBuilder-StaticText übernommene Beschriftung behält ihr &: mit ib_mnemonic wird der Buchstabe unterstrichen und && schreibt ein &. Wie in PowerBuilder ist die Tastenkombination selbst der Accelerator des Feldes, das die Beschriftung benennt.

// The & marks the shortcut letter : "Customer name:" with the C underlined
uo_label.ib_mnemonic = true
uo_label.is_text = "&Customer name:"

Entscheiden, ob sich ein Link öffnet #

Mit ib_veto_links wird ue_hyperlink_opening gefragt, bevor sich ein [hyperlink] öffnet: FALSE hält ihn geschlossen — öffnen Sie ihn auf Ihre Weise oder fragen Sie nach einer Bestätigung — und ue_hyperlink kommt dann mit ab_opened = FALSE.

// Ask before a link opens
uo_text.ib_veto_links = true
uo_text.is_text = "See the [hyperlink=https://pbtoolboxai.net/doc/]documentation[/hyperlink]."

// ue_hyperlink_opening event of uo_text : (string as_url) returns boolean
// Only the pages of the company site open, every other link stays shut
return Left(as_url, 24) = "https://pbtoolboxai.net/"

Best Practices #

• Text ohne Auszeichnung kostet nichts zusätzlich: Ersetzen Sie Ihre PowerBuilder-statictext-Steuerelemente ruhig durchgängig, auch für reinen Text.
• Bevorzugen Sie is_align = uo.ALIGN_START gegenüber "left": Ihre Maske bleibt korrekt, wenn die Anwendung auf Schreibrichtung von rechts nach links umschaltet.
• ib_selectable bleibt standardmäßig ausgeschaltet, wie bei einer Beschriftung. Aktivieren Sie es nur dort, wo Kopieren sinnvoll ist (Vorgangsnummer, technische Fehlermeldung).
• Kombinieren Sie für eine Kopfzeile il_back_color + ii_padding + ib_auto_height: Der Block bemisst sich selbst, wenn der Text seine Länge ändert.
• Aktivieren Sie ib_track_mouse nur, wenn Sie ue_mouse_enter / ue_mouse_leave wirklich skripten.
• Rufen Sie of_reset() auf, bevor Sie einen Block für einen anderen Inhalt wiederverwenden: Andernfalls bleiben ein vorheriger Hintergrund, Rahmen oder Laufschriftmodus bestehen.
• Ein aus PowerBuilder übernommener Bildschirm, dessen Beschriftungen ein & tragen („&Name:“): schalten Sie ib_mnemonic ein, der Buchstabe wird wie im Original unterstrichen.
• Eine SYSTEMfarbe von PowerBuilder (ButtonFace, WindowText…) in il_back_color oder il_text_color bedeutet die Farbe des Designs und wird als -1 zurückgelesen: eine Komponente mit Design übernimmt nicht das Grau von Windows.

Vom gemeinsamen Sockel geerbt #

Diese Mitglieder gibt es bei jeder visuellen Komponente — sie sind nicht dieser eigen. Sie werden einmal in den übergreifenden Kapiteln beschrieben; diese Tabelle sagt nur, wo man sie liest.

Zwei Helfer werden nicht geerbt: of_icon und of_escape_markup liegen auf n_pbt_utils. Deklarieren Sie eines — n_pbt_utils lnv_utils, nichts zu erzeugen — und rufen Sie sie darauf auf.

← Komponentenreferenz · Inhalt des Handbuchs