listbar — `u_pbt_listbar` #

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

Barre de navigation latérale : des sections repliables en accordéon contenant des entrées à icône, avec bandeau d'accent sur l'entrée courante et repli en rail d'icônes.

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

En bref #

Userobject	`u_pbt_listbar`
Classes d'items	`n_pbt_listbar_section` (section) → `n_pbt_listbar_item` (entrée)
Sert à	Remplacer un menu latéral bricolé à coups de boutons par une navigation structurée, thémée et repliable
Options opt-in	`ib_auto_width`, `ib_reorderable`

C'est le seul composant de la bibliothèque à publier ib_auto_width : sa largeur naturelle a un sens, puisque le rail replié est nettement plus étroit que la barre déployée. Le cas courant est d'ailleurs déjà couvert sans rien activer — ib_collapsed = true rétrécit la barre au rail, et lui rend sa largeur au dépliage.

Démarrage rapide #

// event open de la fenetre

// Une section, puis ses entrees : chaque entree s'adresse par section/entree
uo_nav.of_add_section(/*key*/ "nav", /*text*/ "Navigation")
uo_nav.of_add_item(/*keys*/ "nav/home",   /*text*/ "Home",      /*image*/ "mono:img\home.svg")
uo_nav.of_add_item(/*keys*/ "nav/docs",   /*text*/ "Documents", /*image*/ "mono:img\doc.svg")
uo_nav.of_add_item(/*keys*/ "nav/search", /*text*/ "Search",    /*image*/ "mono:img\find.svg")

// Une deuxieme section, avec une seule entree
uo_nav.of_add_section(/*key*/ "settings", /*text*/ "Settings")
uo_nav.of_add_item(/*keys*/ "settings/prefs", /*text*/ "Preferences", /*image*/ "mono:img\gear.svg")

// La selection se pose sur l'ENTREE, par son adresse : la section puis l'entree
uo_nav.of_select_item(/*keys*/ "nav/home")

// of_select_item leve ue_selection_changed, comme un clic : la premiere page s'ouvre la

// event ue_selection_changed de uo_nav : (string as_from_keys, string as_keys)
choose case as_keys
    case "nav/home"       ; of_open_home()
    case "nav/docs"       ; of_open_documents()
    case "settings/prefs" ; of_open_preferences()
end choose

Deux niveaux, une adresse #

Un identifiant d'entrée n'est unique que dans sa section : une entrée se désigne donc par son adresse, la section puis l'entrée jointes par / — "nav/docs". C'est le composant qui la reçoit (of_item, of_select_item, of_remove_item…) ; une section, elle, se désigne par sa seule clé (of_section("nav")). Voir Hiérarchies.

// Une section par sa cle, une entree par son adresse
uo_nav.of_section(/*key*/ "nav").is_title = "Navigation"
uo_nav.of_item(/*keys*/ "nav/docs").is_text = "Documents"

Les events portent eux aussi le chemin complet, et l'entrée quittée avec : ue_selection_changed(as_from_keys, as_keys).

Propriétés #

Propriété	Type	Défaut	Rôle
`ib_collapsed`	boolean	`false`	`true` replie la barre en rail d'icônes : titres de section et libellés laissent place à un filet entre les sections, et toutes les entrées restent visibles, même celles d'une section repliée (le pli revient à la sortie du rail). Une entrée sans icône montre son initiale, et chaque entrée dit son libellé au survol
`ib_auto_width`	boolean	`false`	Opt-in : idem pour la largeur, y compris dépliée (la barre se cale sur le libellé le plus long). Le repli en rail, lui, se rétrécit déjà tout seul ; `ue_auto_width` suit dans les deux cas
`ib_reorderable`	boolean	`false`	Opt-in : l'utilisateur peut déplacer une entrée à la souris. Le déplacement reste dans sa section — un identifiant d'entrée n'est unique que là, donc traverser risquerait deux clés identiques (déclenche `ue_item_reordered`)
`ib_veto_selection`	boolean	`false`	Opt-in : demander avant que la sélection ne bouge — un geste de l'utilisateur et `of_select_item` / `of_clear_selection` (déclenche `ue_selection_changing`, qui peut refuser ; un ordre refusé renvoie `-4`). Désactivé par défaut, comme tout événement annulable de la bibliothèque : posez `true` quand vous devez pouvoir refuser (saisie non enregistrée). Chaque question d'un geste coûte un aller-retour vers PowerBuilder (~35 ms)
`is_theme_style`	string	`""`	Style visuel du composant (constantes `THEME_STYLE_*`) ; vide = celui de l'application, suivi à chaque changement
`is_theme_mode`	string	`""`	Variante claire ou sombre (constantes `THEME_MODE_*`) ; vide = celle de l'application, suivie à chaque changement
`il_theme_accent`	long	`-1`	Couleur d'accent de ce composant (`-1` = l'accent de l'application, ou celui du thème)
`is_tooltip`	string	`""`	Info-bulle simple affichée au survol du composant
`is_super_tooltip_title`	string	`""`	Titre de l'info-bulle enrichie (prend le pas sur `is_tooltip`)
`is_super_tooltip_text`	string	`""`	Texte de l'info-bulle enrichie (balisage riche accepté)
`is_super_tooltip_image`	string	`""`	Image de l'info-bulle enrichie

Propriétés d'une section — `n_pbt_listbar_section` #

Propriété	Type	Défaut	Rôle
`is_title`	string	`""`	Titre de la section. Accepte le balisage riche. Un titre vide n'affiche aucune ligne d'en-tête : la section devient un simple regroupement invisible ; un espace la sépare de la section du dessus (un filet en rail), et elle ne se replie plus — personne ne pourrait la rouvrir
`ib_collapsed`	boolean	`false`	Accordéon : `true` replie les entrées de cette section. L'en-tête reste visible, son chevron pivote ; `ue_section_toggled` suit, comme pour un clic sur l'en-tête
`ib_pinned`	boolean	`false`	`true` épingle la section en bas de la barre (Paramètres, Aide) : un pied qui reste visible pendant que le reste de la barre défile, poussé en bas quand la place ne manque pas, et en bas du rail aussi. Plusieurs sections épinglées s'empilent dans leur ordre. Seul le dessin change : la disposition (`of_get_layout`) garde l'ordre des sections, et la flèche Bas passe de la dernière entrée du haut à la première du pied
`is_image`	string	`""`	Icône devant le titre de la section (formes acceptées : chemin, `mono:`, `tint:`, ressource de DLL). Une chaîne vide la retire
`il_accent`	long	`-1`	Accent de cette section, c'est-à-dire de son titre, et de rien d'autre : ses entrées gardent le leur (`-1` = celui du composant)
`il_back_color`	long	`-1`	Fond du titre de la section, en `RGB(r,v,b)` (`-1` = celui du composant)
`il_text_color`	long	`-1`	Couleur du texte du titre de la section (`-1` = celle du composant)
`il_back_color_hover`	long	`-1`	Fond du titre sous le pointeur (`-1` = celui du composant)
`il_text_color_hover`	long	`-1`	Couleur du texte du titre sous le pointeur (`-1` = celle du composant)

Propriétés d'une entrée — `n_pbt_listbar_item` #

Propriété	Type	Défaut	Rôle
`is_text`	string	`""`	Libellé de l'entrée, modifiable à chaud sans reconstruire la barre. Accepte le balisage riche
`is_image`	string	`""`	Icône, modifiable à chaud (formes acceptées : chemin, `mono:`, `tint:`, ressource de DLL)
`ib_enabled`	boolean	`true`	`false` grise l'entrée : elle reste en place et ne répond plus à rien — ni clic, ni Entrée, ni clic droit, et les flèches la sautent
`ib_visible`	boolean	`true`	`false` masque l'entrée sans la retirer de la barre. Une entrée masquée ne peut pas devenir la sélection (`of_select_item` rend `-5`) ; masquer celle qui est sélectionnée la garde sélectionnée, et la remontrer la rend telle quelle
`is_badge`	string	`""`	Pastille de compteur en fin d'entrée (`"12"` non lus), aux couleurs de pastille du thème ; en rail, sur le coin de l'icône. Tout texte court, balisage accepté. Une chaîne vide la retire
`of_is_selected ( )` → `boolean`	—	—	Cette entrée est-elle la sélectionnée ? Lecture seule, et volontairement : la sélection est un état de la barre entière, pas un drapeau par entrée. Pour la poser, `of_select_item` sur le composant
`is_tooltip`	string	`""`	Info-bulle simple affichée au survol de l'item
`is_super_tooltip_title`	string	`""`	Titre de l'info-bulle enrichie de l'item (prend le pas sur `is_tooltip`)
`is_super_tooltip_text`	string	`""`	Texte de l'info-bulle enrichie de l'item (balisage riche accepté)
`is_super_tooltip_image`	string	`""`	Image de l'info-bulle enrichie de l'item
`il_accent`	long	`-1`	Accent de cette entrée : le liseré qui la marque quand elle est sélectionnée le prend (`-1` = celui du composant). Pour « cette entrée en rouge », `il_back_color` / `il_text_color`
`il_back_color`	long	`-1`	Fond propre à l'entrée, en `RGB(r,v,b)` (`-1` = ce que donne le thème)
`il_text_color`	long	`-1`	Couleur du texte de l'entrée (`-1` = ce que donne le thème)
`il_back_color_hover`	long	`-1`	Fond de l'entrée sous le pointeur (`-1` = ce que donne le thème)
`il_text_color_hover`	long	`-1`	Couleur du texte de l'entrée sous le pointeur (`-1` = ce que donne le thème)

Méthodes #

Sur le composant #

Méthode	Rôle
`of_add_section (string as_key, string as_text)`	Ajoute une section à la fin de la barre. Un texte vide n'affiche aucune ligne de titre. Le handle vient d'`of_section("nav")` quand vous voulez poser une propriété. Renvoie `0` une fois appliqué, `-5` si la clé est vide, déjà prise ou contient `/` ou `	`,` -2` si le composant n'est pas créé
`of_insert_section (string as_key, string as_text, integer ai_index)`	Ajoute une section au rang demandé (première position = 1) plutôt qu'à la fin. L'index compte des sections, pas des lignes. Un nom déjà pris est refusé : deux sections sous un même nom rendraient ambiguë l'adresse de chacune de leurs entrées. Renvoie `0` une fois appliqué, `-5` si la clé est vide, déjà prise ou contient `/` ou `	`,` -2` si le composant n'est pas créé
`of_move_section (string as_key, integer ai_index)`	Déplace une section au rang `ai_index`, avec ses entrées. Déplacer l'en-tête seul larguerait ses entrées dans la section qui se retrouve au-dessus d'elles. Renvoie `0` une fois appliqué, `-5` pour une section que cette barre n'a jamais ajoutée, `-2` si le composant n'est pas créé
`of_remove_section (string as_key)`	Retire une section et tout ce qu'elle contient. La vider en gardant ses entrées les rendrait orphelines : elles porteraient un identifiant de section qui ne nomme plus rien. Si la sélection y était, `ue_selection_changed` annonce qu'il n'y en a plus. Renvoie `0` une fois appliqué, `-5` pour une section que cette barre n'a jamais ajoutée, `-2` si le composant n'est pas créé
`of_section (string as_key)`	Handle d'une section, par sa clé : son titre, son icône, son pli et ses couleurs se posent par lui (créé au premier accès). Une entrée, elle, s'atteint depuis le composant par son adresse (`of_item`)
`of_add_item (string as_keys, string as_text, string as_image)`	Ajoute une entrée à son adresse, `"nav/home"` : la section où elle atterrit, puis son propre identifiant. Une surcharge omet l'icône. Renvoie `0` une fois ajoutée, `-5` si la section n'a pas été ajoutée par cette barre, si l'adresse est déjà prise ou si la clé contient `	`,` -2` si le composant n'est pas créé
`of_item (string as_keys)`	Handle d'une entrée, par son adresse (créé au premier accès)
`of_insert_item (string as_keys, string as_text, integer ai_index)`	Insère une entrée à la position `ai_index` dans sa section (première position = 1). Renvoie `0` une fois ajoutée, `-5` si la section n'a pas été ajoutée par cette barre, si l'adresse est déjà prise ou si la clé contient `	`,` -2` si le composant n'est pas créé
`of_insert_item (string as_keys, string as_text, string as_image, integer ai_index)`	Idem, avec l'icône de l'entrée : `of_add_item` en prend une, insérer doit pouvoir en prendre une aussi. Renvoie `0` une fois ajoutée, `-5` si la section n'a pas été ajoutée par cette barre, si l'adresse est déjà prise ou si la clé contient `	`,` -2` si le composant n'est pas créé
`of_move_item (string as_keys, integer ai_index)`	Déplace une entrée existante dans sa section, en conservant son état. Renvoie `0` une fois appliqué, `-5` pour une adresse que cette barre n'a jamais ajoutée, `-2` si le composant n'est pas créé
`of_remove_item (string as_keys)`	Retire une entrée désignée par son adresse. Si c'était la sélection, `ue_selection_changed` annonce qu'il n'y en a plus. Renvoie `0` une fois appliqué, `-5` pour une adresse que cette barre n'a jamais ajoutée, `-2` si le composant n'est pas créé
`of_clear ( )`	Vide la barre : toutes les sections et toutes les entrées. Si une entrée était sélectionnée, `ue_selection_changed` annonce qu'il n'y en a plus (adresse vide) ; `ue_layout_changed` n'est pas levé, vous reconstruisez. Renvoie `0` une fois appliqué, `-2` si le composant n'est pas créé
`of_select_item (string as_keys)`	Sélectionne une entrée, comme un clic sur elle : avec `ib_veto_selection` actif, `ue_selection_changing` est posée d'abord ; puis `ue_selection_changed` suit, comme pour un clic (juste après votre script, depuis la file d'événements), et `of_selected_key()` lu juste après rend déjà la nouvelle adresse. Entrée déjà sélectionnée : rien n'est demandé ni levé. Renvoie `0` une fois sélectionnée (ou déjà sélectionnée), `-4` si votre `ue_selection_changing` a refusé (rien ne bouge), `-5` pour une adresse que cette barre n'a jamais ajoutée, une entrée masquée ou une entrée que le plafond de démonstration ne dessine pas, `-2` si le composant n'est pas créé
`of_get_layout ( )`	Relit la disposition courante en JSON : les sections dans l'ordre, chacune avec ses entrées dans l'ordre et son état replié. À stocker (fichier, base, registre) et à rendre par `of_set_layout` au démarrage suivant. La même paire porte les mêmes noms sur tous les composants réorganisables
`of_set_layout (string as_layout_json)`	Restaure une disposition lue par `of_get_layout` ou reçue par `ue_layout_changed`. Ce que la disposition ne nomme pas garde sa place à la fin : une disposition d'hier ne doit pas faire disparaître ce qui a été ajouté depuis. L'appliquer ne déclenche aucun event — c'est vous qui l'avez fournie. Renvoie `0` une fois appliqué, `-5` sur un texte vide ou qui n'est pas un objet JSON (un fichier tronqué) : rien n'est envoyé ; le pli d'une section absente est ignoré, `-2` si le composant n'est pas créé
`of_clear_selection ( )`	Ne laisse aucune entrée sélectionnée, comme tout déplacement : avec `ib_veto_selection` actif, `ue_selection_changing` est posée d'abord, puis `ue_selection_changed` suit avec une adresse vide. Rien de sélectionné déjà : rien n'est demandé ni levé. Renvoie `0` une fois appliqué, `-4` si votre `ue_selection_changing` a refusé (l'entrée reste sélectionnée), `-2` si le composant n'est pas créé
`of_selected_key ( )`	Adresse de l'entrée sélectionnée — `"nav/docs"`, `""` si aucune. C'est exactement ce que `ue_selection_changed` vous remet : une comparaison est une comparaison, et non un recollage. Toujours l'entrée courante, lue dans le composant : après un clic, et juste après `of_select_item` aussi
`of_reset ( )`	Vide la barre puis ramène le composant à son état neuf. Si une entrée était sélectionnée, `ue_selection_changed` part avec une adresse vide ; `ue_layout_changed` n'est pas levé. Renvoie `0` une fois appliqué, `-2` si le composant n'est pas créé
`of_set_redraw (boolean)`	Regroupe une rafale de modifications en un seul rendu. Renvoie `0` une fois appliqué, `-2` si le composant n'est pas créé
`of_save_as_png (string)` · `of_save_as_jpg (string)`	Exporte le rendu en image. Renvoie `0` une fois l'image écrite, `-4` si l'écriture échoue, `-2` si le composant n'est pas créé

Sur une section — `n_pbt_listbar_section` #

Méthode	Rôle
`of_count ( )`	Nombre d'entrées de la section, masquées comprises
`of_keys_at (long al_index)`	Adresse de l'entrée de rang `al_index` (à partir de 1) — `"nav/docs"`, réinjectable telle quelle dans `of_item`
`of_has (string as_key)`	La section contient-elle cette entrée ?

Événements #

Événement	Déclenché quand
`ue_selection_changed (string as_from_keys, string as_keys)`	La sélection a bougé : l'utilisateur a choisi une entrée (clic, Entrée, Espace), votre code l'a déplacée (`of_select_item`, `of_clear_selection` — un ordre le lève aussi, comme SelectItem lève SelectionChanged), ou l'entrée sélectionnée est partie (`of_remove_item`, `of_remove_section`, `of_clear`, `of_reset` — `as_keys` est alors vide). Mêmes arguments que `ue_selection_changing` : la question et son issue se lisent pareil, et le couple `as_from_*` désigne l'entrée quittée (vide si aucune)
`ue_section_toggled (string as_key, boolean ab_collapsed)`	L'utilisateur plie ou déplie une section : clic sur son titre, Entrée sur le titre, ou les flèches Gauche / Droite (inversées de droite à gauche), ou votre code qui pose `ib_collapsed` d'une section
`ue_item_reordered (string as_keys, integer ai_index)`	L'utilisateur a fini de faire glisser une entrée. `ai_index` est son nouveau rang dans sa section, à partir de 1, comme `of_move_item`. Conservez cet ordre pour rendre à l'utilisateur sa barre telle qu'il l'a laissée
`ue_layout_changed (string as_layout_json)`	La disposition à conserver a changé : une entrée ou une section a bougé, une section a été pliée ou dépliée, quelque chose a été retiré — par l'utilisateur ou par votre code. Porte la disposition entière, pas seulement ce qui a bougé : la conserver tient en une affectation. Les ajouts, le rail, `of_set_layout`, `of_clear` et `of_reset` ne le lèvent pas : c'est de la construction, pas de l'arrangement
`ue_item_rclicked (string as_keys)`	L'utilisateur a fait un clic droit sur une entrée : son adresse, `"nav/docs"`. Un événement par clic droit, et l'entrée n'est pas sélectionnée. Ouvrez-y votre propre menu, au pointeur : `m_menu.PopMenu(PointerX(), PointerY())`. Une entrée grisée ne lève rien
`ue_selection_changing (string as_from_keys, string as_keys)` → boolean	Annulable, posé avant que la sélection ne bouge — un geste de l'utilisateur, `of_select_item` ou `of_clear_selection` —, et seulement quand `ib_veto_selection = true` (désactivé par défaut). Renvoyez `false` pour rester où vous êtes : rien ne bouge, et l'ordre de votre code renvoie `-4`
`ue_auto_width (long al_width)`	Le composant a recalculé sa largeur idéale — nécessite `ib_auto_width = true`
`ue_ready ( )`	Le composant a fini de charger ; tout ce qui a été envoyé avant a été rejoué
`ue_runtime_missing ( )`	Le runtime WebView2 est absent : le composant reste vide
`ue_bg_color (long al_color)`	Le composant a calculé sa couleur de fond de thème ; l'userobject l'a déjà adoptée (`backcolor`)

Exemples #

// Toute la barre en un seul rendu
uo_nav.of_set_redraw(/*on*/ false)

// Premiere section et ses trois entrees
uo_nav.of_add_section(/*key*/ "folders", /*text*/ "Folders")
uo_nav.of_add_item(/*keys*/ "folders/recent",    /*text*/ "Recent",    /*image*/ "mono:img\clock.svg")
uo_nav.of_add_item(/*keys*/ "folders/customers", /*text*/ "Customers", /*image*/ "mono:img\user.svg")
uo_nav.of_add_item(/*keys*/ "folders/archives",  /*text*/ "Archives",  /*image*/ "mono:img\box.svg")

// Deuxieme section et ses deux entrees
uo_nav.of_add_section(/*key*/ "tools", /*text*/ "Tools")
uo_nav.of_add_item(/*keys*/ "tools/import", /*text*/ "Import", /*image*/ "mono:img\import.svg")
uo_nav.of_add_item(/*keys*/ "tools/export", /*text*/ "Export", /*image*/ "mono:img\export.svg")

// Un seul rendu pour tout, puis la premiere entree est selectionnee
uo_nav.of_set_redraw(/*on*/ true)
uo_nav.of_select_item(/*keys*/ "folders/recent")

Rail repliable qui libère la place #

// Replier en rail d'icones : la barre se retrecit d'elle-meme (et reprend sa
// largeur quand vous la depliez).
uo_nav.ib_collapsed = true

// event ue_auto_width de uo_nav : (long al_width)
// La barre vient d'adopter sa largeur ideale : recaler ce qui se trouve a droite.
uo_content.x     = uo_nav.x + al_width
uo_content.width = parent.width - uo_content.x

Accordéon : replier une section #

// Replier la section des archives, rarement utilisee
uo_nav.of_section(/*key*/ "folders").ib_collapsed = true

// event ue_section_toggled de uo_nav : (string as_key, boolean ab_collapsed)
// Retenir le pli choisi par l'utilisateur
of_save_preference("section_" + as_key, String(ab_collapsed))

Paramètres et Aide épinglés en bas #

Une section sans titre et épinglée : aucune ligne d'en-tête, deux entrées qui restent au pied de la barre même quand la navigation, plus longue que la fenêtre, défile. Un clic y sélectionne comme ailleurs : ue_selection_changed reçoit foot/settings.

// Une section SANS titre (aucune ligne d'en-tete), epinglee en bas de la barre :
// elle reste visible pendant que les entrees du dessus defilent
uo_nav.of_add_section(/*key*/ "foot", /*text*/ "")
uo_nav.of_add_item(/*keys*/ "foot/settings", /*text*/ "Settings", /*image*/ "mono:img\\gear.svg")
uo_nav.of_add_item(/*keys*/ "foot/help",     /*text*/ "Help",     /*image*/ "mono:img\\help.svg")
uo_nav.of_section(/*key*/ "foot").ib_pinned = true

// event ue_selection_changed de uo_nav : (string as_from_keys, string as_keys)
// L'adresse porte les deux niveaux : deux sections peuvent avoir une entree "list".
// Local variables
n_pbt_utils lnv_utils   // autoinstantiate : rien a creer, rien a detruire
string ls_keys[]

// Decoupe l'adresse : [1] = la section, [2] = l'entree
if lnv_utils.of_split_path(/*keys*/ as_keys, /*out*/ ls_keys) < 2 then return
choose case ls_keys[1]
    case "folders" ; of_open_folder(ls_keys[2])
    case "tools"   ; of_run_tool(ls_keys[2])
end choose

Refuser un changement de sélection #

// La question est desactivee par DEFAUT : l'armer pour pouvoir refuser un deplacement
uo_nav.ib_veto_selection = true

// event ue_selection_changing de uo_nav :
//   (string as_from_keys, string as_keys)
// Renvoyer FALSE garde l'utilisateur sur l'entree qu'il quitte.
if of_has_unsaved_changes(as_from_keys) then
    MessageBox("Saisie", "Terminez la fiche en cours avant de naviguer.")
    return false
end if
return true

Mettre une entrée à jour à chaud #

// Local variables
n_pbt_listbar_item lnv_entry

// L'entree se designe par son adresse : la section, puis l'entree
lnv_entry = uo_nav.of_item(/*keys*/ "folders/recent")
lnv_entry.is_text  = "Recent (12)"
lnv_entry.is_image = "mono:img\clock_full.svg"

// Griser ou masquer selon les droits, sans reconstruire la barre
uo_nav.of_item(/*keys*/ "tools/import").ib_enabled = of_is_allowed("import")
uo_nav.of_item(/*keys*/ "tools/export").ib_visible = gb_expert_mode

Sélection pilotée depuis le code #

// Poser la selection ailleurs : le bandeau d'accent suit, et
// ue_selection_changed part comme pour un clic
uo_nav.of_select_item(/*keys*/ "folders/customers")

// Ou l'effacer completement
uo_nav.of_clear_selection()

Reconstruire la barre #

// of_clear vide sections et entrees ; of_reset y ajoute les defauts du composant
uo_nav.of_clear()
of_build_menu_for_profile()

Bonnes pratiques #

Une entrée s'ajoute par son adresse : of_add_item("nav/home", ...). Le handle de section ne sert plus qu'à poser une propriété, et of_section("nav") le rend au premier accès.
Utilisez mono: pour les icônes : elles se recolorent avec le thème, clair comme sombre, et restent lisibles une fois la barre repliée en rail.
Un titre de section vide sert de regroupement discret : un espace sépare les entrées de celles du dessus (un filet en rail) sans qu'aucune ligne d'en-tête n'apparaisse. Une telle section ne se replie pas.
Au clavier : les flèches Haut / Bas parcourent titres et entrées, Gauche / Droite replient et déplient une section (inversées de droite à gauche), Entrée ou Espace choisit, une lettre saute à la ligne suivante qui commence par elle.
ib_collapsed rétrécit l'userobject au rail, mais il ne déplace pas vos autres contrôles : traitez ue_auto_width pour occuper la place libérée, sinon elle reste vide.
En mode rail, seules les icônes subsistent : chaque entrée dit son libellé au survol, et une entrée sans icône montre son initiale. Donnez quand même une icône à chacune — une initiale se distingue mal d'une autre.
La question n'est posée que si vous l'armez (ib_veto_selection = true) : faites-le seulement là où vous devez pouvoir refuser un déplacement, car chaque question coûte un aller-retour vers PowerBuilder. of_select_item ne la pose jamais.
ib_enabled = false vaut mieux que ib_visible = false quand l'entrée redeviendra disponible : le menu ne change pas de forme sous les yeux de l'utilisateur.

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.

Membres	Rôle	Détaillé dans
`of_count` · `of_keys_at` · `of_has`	Parcourir ce que le composant contient	3.2 Les items
`of_reset`	Remettre le composant à zéro	3.6 Remettre un composant à zéro : `of_reset()`
`of_register_shortcut` · `of_clear_shortcuts`	Raccourcis clavier du composant	3.5 Les raccourcis clavier
`of_is_created` · `of_is_ready` · `of_get_last_error`	S'il est né, s'il est prêt, ce qui a échoué	3.7 Diagnostic
`of_save_as_png` · `of_save_as_jpg`	Exporter le rendu en image	3.8 Exporter le rendu en image
`of_set_redraw`	Grouper les modifications en un seul repaint	3.10 Bonnes pratiques
`of_preload_icons`	Icônes affichées sans délai	Affichage instantané : `of_icon`
`of_set_translation`	Traduire un libellé du composant	5.2 Adapter un libellé : `of_set_translation`
`of_focus_webview`	Donner le focus au composant	6.4 Clavier et focus
`of_print` · `of_print_to_pdf`	Imprimer, ou écrire un PDF	6.9 Imprimer
`of_set_property` · `of_get_property` · `of_component_name`	Piloter une propriété par son nom	3.1 Le moteur de propriétés

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

listbar — `u_pbt_listbar` #

En bref #

Démarrage rapide #

Deux niveaux, une adresse #

Propriétés #

Propriétés d'une section — `n_pbt_listbar_section` #

Propriétés d'une entrée — `n_pbt_listbar_item` #

Méthodes #

Sur le composant #

Sur une section — `n_pbt_listbar_section` #

Événements #

Exemples #

Menu latéral complet #

Rail repliable qui libère la place #

Accordéon : replier une section #

Paramètres et Aide épinglés en bas #

Réagir à la navigation #

Refuser un changement de sélection #

Mettre une entrée à jour à chaud #

Sélection pilotée depuis le code #

Reconstruire la barre #

Bonnes pratiques #

Hérité du socle commun #

listbar — u_pbt_listbar #

En bref #

Démarrage rapide #

Deux niveaux, une adresse #

Propriétés #

Propriétés d'une section — n_pbt_listbar_section #

Propriétés d'une entrée — n_pbt_listbar_item #

Méthodes #

Sur le composant #

Sur une section — n_pbt_listbar_section #

Événements #

Exemples #

Menu latéral complet #

Rail repliable qui libère la place #

Accordéon : replier une section #

Paramètres et Aide épinglés en bas #

Réagir à la navigation #

Refuser un changement de sélection #

Mettre une entrée à jour à chaud #

Sélection pilotée depuis le code #

Reconstruire la barre #

Bonnes pratiques #

Hérité du socle commun #

listbar — `u_pbt_listbar` #

Propriétés d'une section — `n_pbt_listbar_section` #

Propriétés d'une entrée — `n_pbt_listbar_item` #

Sur une section — `n_pbt_listbar_section` #