buttonbar aligne une rangée de boutons de commande — icône, libellé, ou les deux — dans un seul composant. Un clic rapporte l'id du bouton (ue_clicked) ; chaque bouton se pilote par un handle (of_button) pour le griser, le colorer, le masquer. C'est le composant à préférer dès qu'il y a plusieurs boutons : un WebView2 pour toute la barre, là où N button séparés en coûteraient N.
▶ Le voir en vrai — Application de démonstration, tuile Button bar, avec le code et cette page côte à côte.
// Une barre d'actions, en trois lignes
uo_bar.of_add_button("save", "mono:img\packimages.dll:svg/samples/save", "Save")
uo_bar.of_add_button("find", "mono:img\packimages.dll:svg/samples/find", "Find")
uo_bar.of_add_button("copy", "", "Copy") // sans icone
// Griser un bouton
uo_bar.of_button("copy").ib_enabled = false
// Reagir : ue_clicked porte l'id du bouton
// (dans l'evenement ue_clicked du composant)
CHOOSE CASE as_key
CASE "save" ; wf_save()
CASE "find" ; wf_find()
END CHOOSE
Retrait gauche/droite de la barre, en pixels : l'espace avant le premier bouton et après le dernier. 0 colle les boutons aux bords
ii_padding_y
integer
12
Retrait haut/bas de la barre, en pixels. Un bouton REMPLIT la hauteur de la barre : c'est donc ce retrait qui décide de la hauteur des boutons (barre plus haute ou retrait plus petit = boutons plus hauts). 12 par défaut ; -1 = celui du thème
ii_gap
integer
-1
Espace ENTRE deux boutons, en pixels. -1 (défaut) = celui du thème : un thème classique accole les boutons (avec un trait de séparation), les autres les détachent. 0 les accole quel que soit le thème
is_align
string
end
Aligne la rangée : start (gauche), center, end (droite, défaut, comme une boîte de dialogue) ou justify (boutons à largeurs égales sur toute la largeur). Valeurs logiques (RTL) — constantes ALIGN_*
is_default
string
""
Clé du bouton par défaut — l'action principale, peinte avec l'accent, que Entrée déclenche (comme le OK d'une boîte de dialogue). Vide = aucun ; un seul bouton par défaut à la fois
is_cancel
string
""
Clé du bouton annuler — celui que Échap déclenche (comme le Annuler d'une boîte de dialogue). Vide = aucun ; un seul bouton annuler à la fois
is_theme_style
string
fluent
Style visuel du composant (constantes THEME_STYLE_*)
is_theme_mode
string
light
Variante claire ou sombre (constantes THEME_MODE_*)
il_theme_accent
long
-1
Couleur d'accent de ce composant (-1 = accent 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é)
of_add_button (string as_key, string as_image_file, string as_text) → long
Ajoute un bouton de commande (id, fichier image, libellé) à la fin de la barre. mono: sur l'image la recolore au thème ; un libellé vide fait un bouton icône seule. Rend 0, -5 sur une clé vide ou un bouton sans image ni texte
Insère un bouton de commande à la position ai_index (à partir de 1), décalant les suivants. Rend 0, -5 sur une clé vide ou un bouton sans image ni texte
of_remove_button (string as_key) → long
Retire un bouton par sa clé ; les autres gardent leur état vivant. Rend 0, -5 sur une clé vide
of_move_button (string as_key, integer ai_index) → long
Déplace un bouton à la position ai_index (à partir de 1) sans perdre son état vivant. Rend 0, -5 sur une clé vide
of_clear_buttons ( ) → long
Retire tous les boutons de la barre. Rend 0, -2 si non créé
Active ou grise un bouton ; grisé, il ne se clique pas
ib_visible
boolean
true
Affiche ou masque un bouton ; masqué, il garde sa place et revient où il était
is_text
string
""
Libellé du bouton ; à changer après l'ajout
is_image
string
""
Icône du bouton (fichier image ; mono: suit le thème) ; à changer après l'ajout
il_badge
long
0
Petit badge de comptage dans le coin du bouton (0 = aucun)
is_shortcut
string
""
Mnémonique de ce bouton : Alt+la lettre le déclenche, et la lettre est soulignée dans son libellé. Une seule lettre (la première est utilisée) ; vide = aucune
il_back_color
long
-1
Fond de CE bouton (-1 = celui du composant, qui suit le thème)
il_text_color
long
-1
Couleur du texte de CE bouton (-1 = celle du composant)
il_back_color_hover
long
-1
Fond de CE bouton au survol (-1 = celui du composant)
il_text_color_hover
long
-1
Couleur du texte de CE bouton au survol (-1 = celle du composant)
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.