tab — u_pbt_tab #

← Komponentenreferenz · Inhalt des Handbuchs

Moderne Registerkarten, die echte PowerBuilder-Steuerelemente hosten: verschiebbare Registerleiste, Symbole je Registerkarte, schließbare Registerkarten, Umsortieren mit der Maus.

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

Auf einen Blick #

Der entscheidende Punkt: Eine Seite ist kein HTML-Entwurf, sondern ein PowerBuilder-dragobject — ein Userobject, eine DataWindow, eine Gruppe von Steuerelementen oder sogar eine weitere PBToolboxAI-Komponente. Die Komponente übernimmt das Positionieren, das Anpassen der Größe sowie das Ein- und Ausblenden beim Wechsel der Registerkarte. Siehe Echte PowerBuilder-Steuerelemente hosten.

Schnellstart #

// open-Event des Fensters : jede Seite ist ein PB-Steuerelement, das bereits auf dem Fenster liegt
uo_tabs.of_add_page(/*key*/ "customers",  /*title*/ "Kunden",  /*page*/ uo_page_customers)
uo_tabs.of_add_page(/*key*/ "invoices", /*title*/ "Rechnungen", /*page*/ uo_page_invoices, /*closable*/ true)

// Ein Symbol je Registerkarte, am Handle der Seite gesetzt
uo_tabs.of_page(/*key*/ "customers").is_icon  = "mono:img\customers.svg"
uo_tabs.of_page(/*key*/ "invoices").is_icon = "mono:img\invoice.svg"

// Die erste Registerkarte anzeigen
uo_tabs.of_select_page(/*key*/ "customers")

// Event ue_selection_changed von uo_tabs : (string as_from_key, string as_key)
// Ein leerer Schluessel : keine Registerkarte wird mehr angezeigt (alle ausgeblendet)
if as_key <> "" then of_load_page(as_key)

Eigenschaften #

Eigenschaften einer Seite — n_pbt_tab_page #

Über of_page(id) bezogen, lassen sie sich im laufenden Betrieb ändern, ohne die Leiste neu aufzubauen.

Methoden #

of_add_page gibt einen negativen Code zurück, wenn der Bezeichner leer ist, bereits verwendet wird oder wenn das übergebene Steuerelement ungültig oder bereits gehostet ist.

Wenn zu viele Registerkarten offen sind — sie schrumpfen, um in das Band zu passen, aber nie unter eine lesbare Breite: Symbol und Schließkreuz beanspruchen ihren Platz zusätzlich zum Titel, nie auf dessen Kosten. Was nicht mehr hineinpasst, wird aus dem Band genommen, und an dessen Ende erscheint eine Schaltfläche ···: Sie öffnet die Liste aller sichtbaren Registerkarten, die aktive angehakt, und die Auswahl wechselt dorthin. Die aktive Registerkarte bleibt immer sichtbar. Das Band scrollt nicht — diese Schaltfläche ist der Weg zu den Registerkarten außerhalb des Rahmens. Nichts zu programmieren, das Verhalten ist automatisch.

Tastatur und Maus — Strg+Tab und Strg+Bild ab wechseln zur nächsten Registerkarte, Strg+Umschalt+Tab und Strg+Bild auf zur vorherigen: Es zählen nur Registerkarten, die aktiv werden können (ausgeblendete und ausgegraute werden übersprungen), und der Durchlauf beginnt am Ende wieder von vorn. Diese Tasten wirken, wenn die Tastatur im Registerkartenband oder in einer Seite ist, die es hostet — ein PowerBuilder-Steuerelement der Seite ebenso wie eine andere darin platzierte Komponente; aus einem Steuerelement außerhalb des Tabs bleiben sie beim Fenster. Es ist eine Geste des Benutzers: ue_selection_changing wird gestellt, wenn ib_veto_selection aktiv ist, danach folgt ue_selection_changed. Ein Mittelklick auf eine schließbare Registerkarte schließt sie, genau wie ihr Kreuz: dieselbe Frage ue_tab_closing, wenn ib_veto_close aktiv ist, danach ue_tab_closed; auf einer ausgegrauten oder nicht schließbaren Registerkarte bewirkt er nichts. Nichts zu programmieren. Umschalt+F10 oder die Menütaste auf einer Registerkarte öffnet ihr Menü unter der Registerkarte; Strg+Umschalt+Pfeil verschiebt die Registerkarte mit Fokus, wenn ib_reorderable auf true steht. Braucht eine Seite Strg+Tab selbst, setzen Sie ib_cycle_keys auf false.

Events #

Beispiele #

Ein Ordner mit fachlichen Seiten #

// open-Event : die Seiten-Userobjects liegen bereits auf dem Fenster
uo_tabs.of_set_redraw(/*on*/ false)

// Eine Registerkarte je Seiten-Userobject
uo_tabs.of_add_page(/*key*/ "identity", /*title*/ "Identität",  /*page*/ uo_identity)
uo_tabs.of_add_page(/*key*/ "addresses", /*title*/ "Adressen",  /*page*/ uo_addresses)
uo_tabs.of_add_page(/*key*/ "accounting",   /*title*/ "Buchhaltung", /*page*/ uo_accounting)

// Ein Symbol je Registerkarte, am Handle der Seite gesetzt
uo_tabs.of_page(/*key*/ "identity").is_icon = "mono:img\user.svg"
uo_tabs.of_page(/*key*/ "addresses").is_icon = "mono:img\map.svg"
uo_tabs.of_page(/*key*/ "accounting").is_icon   = "mono:img\euro.svg"

// Ein einziges Rendern fuer alles, dann wird die erste Registerkarte angezeigt
uo_tabs.of_set_redraw(/*on*/ true)
uo_tabs.of_select_page(/*key*/ "identity")

Schließbare Dokumente, bei Bedarf geöffnet #

// Local variables
string ls_key, ls_label

// Ein Dokument in einer neuen schliessbaren Registerkarte oeffnen : Schluessel und Titel
ls_key = "report42"
ls_label = "Bericht 42"
uo_tabs.of_add_page(/*key*/ ls_key, /*title*/ ls_label, /*page*/ uo_editor, /*closable*/ true, /*icon*/ "mono:img\doc.svg")
uo_tabs.of_select_page(/*key*/ ls_key)

// Event ue_tab_closed von uo_tabs : (string as_key)
// Die Registerkarte ist bereits entfernt ; es bleibt nur, Ihre Fachdaten freizugeben.
of_free_document(as_key)

// Das Kreuz nur auf der aktiven Registerkarte, ein Punkt auf einer Seite mit
// nicht gespeicherter Arbeit, und ein Zaehler auf einer anderen
uo_tabs.is_close_mode = uo_tabs.CLOSE_ACTIVE
uo_tabs.of_page(/*key*/ "report42").ib_modified = true
uo_tabs.of_page(/*key*/ "inbox").is_badge = "3"

Seiten bei Bedarf erzeugen #

Eine schwere Seite muss nicht existieren, bevor sie besucht wird: Fügen Sie sie ohne ihr Steuerelement hinzu und erzeugen Sie es in ue_page_needed, wie das CreateOnDemand eines PowerBuilder-Tabs.

// open-Event des Fensters : die schweren Seiten werden OHNE ihr Steuerelement hinzugefuegt
uo_tabs.of_add_page(/*key*/ "orders", /*title*/ "Auftraege")
uo_tabs.of_add_page(/*key*/ "history", /*title*/ "Verlauf")

// Event ue_page_needed von uo_tabs : (string as_key)
// Local variables
u_orders luo_orders

// Die Seite wird zum ersten Mal gezeigt : ihr Steuerelement erzeugen, dann uebergeben
if as_key = "orders" then
    parent.OpenUserObject(luo_orders)
    uo_tabs.of_supply_page(/*key*/ as_key, /*page*/ luo_orders)
end if

Umsortieren mit der Maus #

// The user may drag a tab to a new place
uo_tabs.ib_reorderable = true

// Event ue_tab_reordered von uo_tabs : (string as_key, integer ai_index)
// ai_index = neue Position, beginnend bei 1 (wie of_move_page) : wir speichern die gewaehlte Reihenfolge.
of_save_order(as_key, ai_index)

Senkrechte Leiste #

// Registerleiste an der linken Seite, nuetzlich bei langen Beschriftungen
uo_tabs.is_position = uo_tabs.POSITION_START

Eine Registerkarte je nach Rechten grau ausblenden oder verbergen #

// Der Weg fuehrt immer ueber das Handle der Seite
uo_tabs.of_page(/*key*/ "accounting").ib_enabled = of_is_allowed("accounting")
uo_tabs.of_page(/*key*/ "audit").ib_visible  = gb_expert_mode

Auf die Auswahl reagieren #

// Event ue_selection_changed von uo_tabs : (string as_from_key, string as_key)
choose case as_key
    case "identity" ; uo_identity.of_refresh()
    case "addresses" ; uo_addresses.of_refresh()
    case "accounting"   ; uo_accounting.of_refresh()
end choose

Einen Registerkartenwechsel oder ein Schließen ablehnen #

// Beide Fragen muessen EINGESCHALTET werden: ohne diese Zeilen fragt die
// Komponente nichts und wechselt oder schliesst sofort.
uo_tabs.ib_veto_selection = true
uo_tabs.ib_veto_close     = true

// Event ue_selection_changing von uo_tabs : (string as_from_key, string as_key)
// FALSE zurueckzugeben haelt den Benutzer auf der Seite, die er verlaesst.
if of_page_modified(as_from_key) then
    if MessageBox("Änderungen", "Ohne Speichern verlassen?", Question!, YesNo!) = 2 then
        return false
    end if
end if
return true

// Event ue_tab_closing von uo_tabs : (string as_key)
// FALSE zurueckzugeben haelt die Registerkarte und ihre gehostete Seite offen.
return not of_page_modified(as_key)

Wieder mit einer leeren Leiste beginnen #

// of_reset gibt JEDE gehostete Seite an ihr urspruengliches Fenster zurueck, bevor geleert wird
uo_tabs.of_reset()
uo_tabs.of_add_page(/*key*/ "home", /*title*/ "Startseite", /*page*/ uo_home)

Best Practices #

• Die gehosteten Steuerelemente müssen vor dem Aufruf vorhanden sein: Legen Sie sie zur Entwurfszeit auf das Fenster, die Komponente kümmert sich um das Ausblenden und das Neupositionieren.
• Laden Sie die Seiten einmal im open-Event und steuern Sie danach nur noch die Auswahl: Das ist schneller, als fortlaufend Seiten hinzuzufügen und zu entfernen.
• Rufen Sie of_preload_icons beim Start auf, wenn Ihre Registerkarten Symbole tragen: Andernfalls zeigt sich beim ersten Öffnen einer ausgeblendeten Registerkarte eine kurze Verzögerung, bevor das Symbol erscheint.
• Beide Fragen sind opt-in: Setzen Sie ib_veto_selection / ib_veto_close auf true, um einen Registerkartenwechsel oder ein Schließen ablehnen zu können (ein leer gelassenes Ereignis erlaubt die Aktion immer). Jede Frage kostet einen Hin- und Rückweg zu PowerBuilder.
• Ein gehostetes Steuerelement ist ein natives Fenster: Es zeichnet sich über der Web-Ebene. Kein visueller Effekt der Komponente kann darüber hinweggehen.
• Vergessen Sie of_reset() nicht, bevor Sie eine Leiste neu aufbauen: Ohne diesen Aufruf schlägt die Wiederverwendung eines Seitenbezeichners fehl und die vorherigen Steuerelemente bleiben sichtbar.
• Für Bereiche, die sich in der Größe ändern und abdocken lassen, statt sich gegenseitig ausschließender Seiten, greifen Sie besser zu dockcontainer.
• Mit der Tastatur folgt die Registerleiste ihrer Achse: Links/Rechts (bei Schreibrichtung von rechts nach links vertauscht), Oben/Unten in den Positionen start/end, Pos1/Ende, Eingabe oder Leertaste zum Aktivieren, Entf zum Schließen einer schließbaren Registerkarte. Deaktivierte und aus der Leiste verdrängte Registerkarten werden übersprungen.
• Viele schwere Seiten? Fügen Sie sie ohne ihr Steuerelement hinzu (of_add_page(key, title)) und erzeugen Sie jede in ue_page_needed: Die Maske öffnet sich schnell, und nur besuchte Seiten existieren.

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