buttonbar lays out a row of command buttons — icon, label, or both — in one component. A click reports the button id (ue_clicked); each button is driven by a handle (of_button) to disable, colour or hide it. It is the component to prefer as soon as there are several buttons: one WebView2 for the whole bar, where N separate button would cost N.
▶ See it live — Demo application, Button bar tile, with the code and this page side by side.
// 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
Left/right inset of the bar, in pixels: the space before the first button and after the last one. 0 presses the buttons to the edges
ii_padding_y
integer
12
Top/bottom inset of the bar, in pixels. A button FILLS the bar's height, so this inset decides how tall the buttons are (a taller bar, or a smaller inset, gives taller buttons). 12 by default; -1 = the theme's
ii_gap
integer
-1
Space BETWEEN two buttons, in pixels. -1 (default) = the theme's: a classic theme joins the buttons (with a separator line), the others detach them. 0 joins them whatever the theme
is_align
string
end
Aligns the row: start (left), center, end (right, default, like a dialog) or justify (equal-width buttons across the full width). Logical (RTL-aware) values — ALIGN_* constants
is_default
string
""
Key of the default button — the primary action, painted with the accent, that Enter fires (like a dialog's OK). Empty = none; only one default button at a time
is_cancel
string
""
Key of the cancel button — the one Escape fires (like a dialog's Cancel). Empty = none; only one cancel button at a time
is_theme_style
string
fluent
Visual style of the component (THEME_STYLE_* constants)
is_theme_mode
string
light
Light or dark variant (THEME_MODE_* constants)
il_theme_accent
long
-1
Accent color of this component (-1 = the theme accent)
is_tooltip
string
""
Simple tooltip shown when hovering the component
is_super_tooltip_title
string
""
Title of the rich tooltip (takes precedence over is_tooltip)
of_add_button (string as_key, string as_image_file, string as_text) → long
Adds a command button (id, image file, label) at the end of the bar. mono: on the image recolours it to the theme; an empty label makes an icon-only button. Returns 0, -5 on an empty key or a button with neither image nor text
Inserts a command button at position ai_index (0 based), shifting the rest right. Returns 0, -5 on an empty key or a button with neither image nor text
of_remove_button (string as_key) → long
Removes one button by its key; the others keep their live state. Returns 0, -5 on an empty key
of_move_button (string as_key, integer ai_index) → long
Moves one button to position ai_index (0 based) without losing its live state. Returns 0, -5 on an empty key
of_clear_buttons ( ) → long
Removes every button from the bar. Returns 0, -2 when not created
These members exist on every visual component — they are not specific to this one. They are detailed once, in the transverse chapters; this table only says where to read them.