buttonbar dispone una fila di pulsanti di comando — icona, etichetta o entrambi — in un solo componente. Un clic riporta l'id del pulsante (ue_clicked); ogni pulsante si pilota con un handle (of_button) per disabilitarlo, colorarlo o nasconderlo. Il componente da preferire non appena ci sono più pulsanti: un WebView2 per tutta la barra, dove N button separati ne costerebbero N.
▶ Vederlo dal vivo — Applicazione dimostrativa, tessera Button bar, con il codice e questa pagina fianco a fianco.
// 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
Rientro sinistro/destro della barra, in pixel: lo spazio prima del primo pulsante e dopo l'ultimo. 0 accosta i pulsanti ai bordi
ii_padding_y
integer
12
Rientro alto/basso della barra, in pixel. Un pulsante RIEMPIE l'altezza della barra: questo rientro decide quindi l'altezza dei pulsanti (barra più alta o rientro minore = pulsanti più alti). 12 per impostazione predefinita; -1 = quello del tema
ii_gap
integer
-1
Spazio TRA due pulsanti, in pixel. -1 (predefinito) = quello del tema: un tema classico unisce i pulsanti (con una linea di separazione), gli altri li separano. 0 li unisce in ogni tema
is_align
string
end
Allinea la fila: start (sinistra), center, end (destra, predefinito, come una finestra di dialogo) o justify (pulsanti di uguale larghezza su tutta la larghezza). Valori logici (RTL) — costanti ALIGN_*
is_default
string
""
Chiave del pulsante predefinito — l'azione primaria, colorata con l'accento, che Invio attiva (come l'OK di una finestra di dialogo). Vuoto = nessuno; un solo pulsante predefinito alla volta
is_cancel
string
""
Chiave del pulsante annulla — quello che Esc attiva (come l'Annulla di una finestra di dialogo). Vuoto = nessuno; un solo pulsante annulla alla volta
is_theme_style
string
fluent
Stile visivo del componente (costanti THEME_STYLE_*)
is_theme_mode
string
light
Variante chiara o scura (costanti THEME_MODE_*)
il_theme_accent
long
-1
Colore d'accento di questo componente (-1 = accento del tema)
is_tooltip
string
""
Tooltip semplice mostrato al passaggio del mouse sul componente
is_super_tooltip_title
string
""
Titolo del tooltip avanzato (prevale su is_tooltip)
is_super_tooltip_text
string
""
Testo del tooltip avanzato (markup avanzato accettato)
of_add_button (string as_key, string as_image_file, string as_text) → long
Aggiunge un pulsante di comando (id, file immagine, etichetta) in fondo alla barra. mono: sull'immagine la ricolora sul tema; un'etichetta vuota crea un pulsante solo icona. Restituisce 0, -5 con chiave vuota o senza immagine né testo
Inserisce un pulsante di comando alla posizione ai_index (à partir de 1), spostando gli altri. Restituisce 0, -5 con chiave vuota o senza immagine né testo
of_remove_button (string as_key) → long
Rimuove un pulsante per chiave; gli altri mantengono il loro stato vivo. Restituisce 0, -5 con chiave vuota
of_move_button (string as_key, integer ai_index) → long
Sposta un pulsante alla posizione ai_index (à partir de 1) senza perdere il suo stato vivo. Restituisce 0, -5 con chiave vuota
of_clear_buttons ( ) → long
Rimuove tutti i pulsanti dalla barra. Restituisce 0, -2 se non creato
Abilita o disabilita un pulsante; disabilitato, non si clicca
ib_visible
boolean
true
Mostra o nasconde un pulsante; nascosto, mantiene il posto e ritorna dov'era
is_text
string
""
Etichetta del pulsante; da cambiare dopo l'aggiunta
is_image
string
""
Icona del pulsante (file immagine; mono: segue il tema); da cambiare dopo l'aggiunta
il_badge
long
0
Piccolo badge di conteggio nell'angolo del pulsante (0 = nessuno)
is_shortcut
string
""
Mnemonico di questo pulsante: Alt+la lettera lo attiva, e la lettera è sottolineata nella sua etichetta. Una lettera (si usa la prima); vuoto = nessuno
il_back_color
long
-1
Sfondo di QUESTO pulsante (-1 = quello del componente, che segue il tema)
il_text_color
long
-1
Colore del testo di QUESTO pulsante (-1 = quello del componente)
il_back_color_hover
long
-1
Sfondo di QUESTO pulsante al passaggio (-1 = quello del componente)
il_text_color_hover
long
-1
Colore del testo di QUESTO pulsante al passaggio (-1 = quello del componente)
il_accent
long
-1
Accento di QUESTO pulsante (-1 = accento del componente)
Questi membri esistono su tutti i componenti visivi — non sono propri di questo. Sono descritti una sola volta, nei capitoli trasversali; questa tabella dice solo dove leggerli.