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_onglets.of_add_page("clients",  "Kunden",  uo_page_clients)
uo_onglets.of_add_page("factures", "Rechnungen", uo_page_factures, /*schliessbar*/ true)

// Ein Symbol je Registerkarte, am Handle der Seite gesetzt
uo_onglets.of_page("clients").is_icon  = "mono:img\clients.svg"
uo_onglets.of_page("factures").is_icon = "mono:img\invoice.svg"

uo_onglets.of_select_page("clients")

// Event ue_selection_changed von uo_onglets : (string as_from_key, string as_key)
of_charger_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 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.

Events #

Beispiele #

Ein Ordner mit fachlichen Seiten #

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

uo_onglets.of_add_page(/*key*/ "identite", /*titel*/ "Identität",  /*seite*/ uo_identite)
uo_onglets.of_add_page(/*key*/ "adresses", /*titel*/ "Adressen",  /*seite*/ uo_adresses)
uo_onglets.of_add_page(/*key*/ "compta",   /*titel*/ "Buchhaltung", /*seite*/ uo_compta)

uo_onglets.of_page("identite").is_icon = "mono:img\user.svg"
uo_onglets.of_page("adresses").is_icon = "mono:img\map.svg"
uo_onglets.of_page("compta").is_icon   = "mono:img\euro.svg"

uo_onglets.of_set_redraw(true)
uo_onglets.of_select_page("identite")

Schließbare Dokumente, bei Bedarf geöffnet #

// Ein Dokument in einer neuen schliessbaren Registerkarte oeffnen
uo_onglets.of_add_page(/*key*/ ls_cle, /*titel*/ ls_libelle, /*seite*/ uo_editeur, &
                       /*schliessbar*/ true, /*symbol*/ "mono:img\doc.svg")
uo_onglets.of_select_page(ls_cle)

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

Umsortieren mit der Maus #

uo_onglets.ib_reorderable = true

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

Senkrechte Leiste #

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

Eine Registerkarte je nach Rechten grau ausblenden oder verbergen #

// Der Weg fuehrt immer ueber das Handle der Seite
uo_onglets.of_page("compta").ib_enabled = of_a_le_droit("compta")
uo_onglets.of_page("audit").ib_visible  = gb_mode_expert

Auf die Auswahl reagieren #

// Event ue_selection_changed von uo_onglets : (string as_from_key, string as_key)
choose case as_key
    case "identite" ; uo_identite.of_rafraichir()
    case "adresses" ; uo_adresses.of_rafraichir()
    case "compta"   ; uo_compta.of_rafraichir()
end choose

Einen Registerkartenwechsel oder ein Schließen ablehnen #

// Beide Fragen werden STANDARDMAESSIG gestellt: nichts zu aktivieren. Diese
// Zeilen tun das Gegenteil und entfernen sie, wo die Abwaegung nichts bringt.
uo_onglets.ib_veto_selection = false
uo_onglets.ib_veto_close     = false

// Event ue_selection_changing von uo_onglets : (string as_from_key, string as_key)
// FALSE zurueckzugeben haelt den Benutzer auf der Seite, die er verlaesst.
if of_page_modifiee(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_onglets : (string as_key)
// FALSE zurueckzugeben haelt die Registerkarte und ihre gehostete Seite offen.
return not of_page_modifiee(as_key)

Wieder mit einer leeren Leiste beginnen #

// of_reset gibt JEDE gehostete Seite an ihr urspruengliches Fenster zurueck, bevor geleert wird
uo_onglets.of_reset()
uo_onglets.of_add_page("accueil", "Startseite", uo_accueil)

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 werden standardmäßig gestellt: Ein leer gelassenes Ereignis erlaubt die Aktion immer, Sie müssen nichts tun. Schalten Sie sie mit ib_veto_selection / ib_veto_close auf false ab, wenn die Abwägung Ihnen nichts bringt, denn 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.

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