tab — u_pbt_tab #

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

Onglets modernes hébergeant de vrais contrôles PowerBuilder : bandeau repositionnable, icônes par onglet, onglets fermables, réordonnancement à la souris.

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

En bref #

L'argument clé : une page n'est pas une maquette HTML, c'est un dragobject PowerBuilder — un userobject, une DataWindow, un groupe de contrôles, voire un autre composant PBToolboxAI. Le composant se charge du positionnement, du redimensionnement et de l'affichage/masquage au changement d'onglet. Voir Héberger de vrais contrôles PowerBuilder.

Démarrage rapide #

// event open de la fenetre : chaque page est un controle PB deja pose sur la fenetre
uo_onglets.of_add_page("clients",  "Clients",  uo_page_clients)
uo_onglets.of_add_page("factures", "Factures", uo_page_factures, /*fermable*/ true)

// Une icone par onglet, posee sur le handle de la page
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 de uo_onglets : (string as_from_key, string as_key)
of_charger_page(as_key)

Propriétés #

Propriétés d'une page — n_pbt_tab_page #

Obtenues par of_page(id), elles se modifient à chaud, sans reconstruire le bandeau.

Méthodes #

of_add_page renvoie un code négatif si l'identifiant est vide, déjà utilisé, ou si le contrôle passé n'est pas valide.

Quand il y a trop d'onglets — ils se réduisent pour tenir dans la bande, mais pas en dessous d'une largeur lisible : l'icône et la croix de fermeture prennent leur place en plus du titre, jamais à sa place. Ceux qui ne tiennent plus sortent de la bande, et un bouton ··· apparaît à son extrémité : il ouvre la liste de tous les onglets visibles, l'actif coché, et le choix bascule dessus. L'onglet actif reste toujours affiché. La bande ne défile pas — ce bouton est le chemin d'accès aux onglets sortis du cadre. Rien à coder, le comportement est automatique.

Événements #

Exemples #

Un classeur de pages métier #

// event open : les userobjects de page sont deja poses sur la fenetre
uo_onglets.of_set_redraw(false)

uo_onglets.of_add_page(/*key*/ "identite", /*titre*/ "Identite",  /*page*/ uo_identite)
uo_onglets.of_add_page(/*key*/ "adresses", /*titre*/ "Adresses",  /*page*/ uo_adresses)
uo_onglets.of_add_page(/*key*/ "compta",   /*titre*/ "Comptabilite", /*page*/ 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")

Documents fermables, ouverts à la demande #

// Ouvrir un document dans un nouvel onglet fermable
uo_onglets.of_add_page(/*key*/ ls_cle, /*titre*/ ls_libelle, /*page*/ uo_editeur, &
                       /*fermable*/ true, /*icone*/ "mono:img\doc.svg")
uo_onglets.of_select_page(ls_cle)

// event ue_tab_closed de uo_onglets : (string as_key)
// L'onglet est deja retire ; il reste a liberer vos donnees metier.
of_liberer_document(as_key)

Réordonnancement à la souris #

uo_onglets.ib_reorderable = true

// event ue_tab_reordered de uo_onglets : (string as_key, integer ai_index)
// ai_index = nouvelle position, a partir de 1 : on memorise l'ordre choisi.
of_enregistrer_ordre(as_key, ai_index)

Bandeau vertical #

// Bande d'onglets sur le cote gauche, utile quand les libelles sont longs
uo_onglets.is_position = uo_onglets.POSITION_START

Griser ou masquer un onglet selon les droits #

// Le chemin passe toujours par le handle de la page
uo_onglets.of_page("compta").ib_enabled = of_a_le_droit("compta")
uo_onglets.of_page("audit").ib_visible  = gb_mode_expert

Réagir à la sélection #

// event ue_selection_changed de 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

Refuser un changement d'onglet ou une fermeture #

// Les deux questions sont posees par DEFAUT : rien a activer. Ces lignes font
// l'inverse, elles les suppriment quand l'arbitrage ne sert pas.
uo_onglets.ib_veto_selection = false
uo_onglets.ib_veto_close     = false

// event ue_selection_changing de uo_onglets : (string as_from_key, string as_key)
// Renvoyer FALSE garde l'utilisateur sur la page qu'il quitte.
if of_page_modifiee(as_from_key) then
    if MessageBox("Modifications", "Quitter sans enregistrer ?", Question!, YesNo!) = 2 then
        return false
    end if
end if
return true

// event ue_tab_closing de uo_onglets : (string as_key)
// Renvoyer FALSE garde l'onglet et sa page hebergee ouverts.
return not of_page_modifiee(as_key)

Repartir d'un bandeau vide #

// of_reset rend CHAQUE page hebergee a sa fenetre d'origine avant de vider
uo_onglets.of_reset()
uo_onglets.of_add_page("accueil", "Accueil", uo_accueil)

Bonnes pratiques #

• Les contrôles hébergés doivent exister avant l'appel : posez-les sur la fenêtre à la conception, le composant se charge de les masquer et de les repositionner.
• Chargez les pages une fois à l'open, puis pilotez uniquement la sélection : c'est plus rapide qu'ajouter et retirer des pages en continu.
• Appelez of_preload_icons au démarrage si vos onglets portent des icônes : sans cela, la première ouverture d'un onglet masqué montre un court délai avant l'icône.
• Les deux questions sont posées par défaut : un événement laissé vide autorise toujours l'action, vous n'avez rien à faire. Coupez-les avec ib_veto_selection / ib_veto_close à false si l'arbitrage ne vous sert pas, car chaque question coûte un aller-retour vers PowerBuilder.
• Un contrôle hébergé est une fenêtre native : il se dessine au-dessus de la couche web. Aucun effet visuel du composant ne peut passer par-dessus lui.
• N'oubliez pas of_reset() avant de reconstruire un bandeau : sans lui, réutiliser un identifiant de page échoue et les contrôles précédents restent affichés.
• Pour des zones redimensionnables et détachables plutôt que des pages exclusives, préférez dockcontainer.

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