buttonbar alinea una fila de botones de comando — icono, etiqueta o ambos — en un solo componente. Un clic informa el id del botón (ue_clicked); cada botón se controla con un handle (of_button) para deshabilitarlo, colorearlo u ocultarlo. El componente a preferir en cuanto hay varios botones: un WebView2 para toda la barra, donde N button separados costarían N.
▶ Verlo en vivo — Aplicación de demostración, mosaico Button bar, con el código y esta página lado a lado.
// 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
Sangría izquierda/derecha de la barra, en píxeles: el espacio antes del primer botón y después del último. 0 pega los botones a los bordes
ii_padding_y
integer
12
Sangría superior/inferior de la barra, en píxeles. Un botón LLENA la altura de la barra: esta sangría decide la altura de los botones (barra más alta o sangría menor = botones más altos). 12 por defecto; -1 = la del tema
ii_gap
integer
-1
Espacio ENTRE dos botones, en píxeles. -1 (por defecto) = el del tema: un tema clásico junta los botones (con una línea separadora), los otros los separan. 0 los junta sea cual sea el tema
is_align
string
end
Alinea la fila: start (izquierda), center, end (derecha, predeterminado, como un cuadro de diálogo) o justify (botones de igual ancho en todo el ancho). Valores lógicos (RTL) — constantes ALIGN_*
is_default
string
""
Clave del botón predeterminado — la acción principal, pintada con el acento, que Intro activa (como el Aceptar de un cuadro de diálogo). Vacío = ninguno; solo un botón predeterminado a la vez
is_cancel
string
""
Clave del botón cancelar — el que Esc activa (como el Cancelar de un cuadro de diálogo). Vacío = ninguno; solo un botón cancelar a la vez
is_theme_style
string
fluent
Estilo visual del componente (constantes THEME_STYLE_*)
is_theme_mode
string
light
Variante clara u oscura (constantes THEME_MODE_*)
il_theme_accent
long
-1
Color de acento de este componente (-1 = acento del tema)
is_tooltip
string
""
Tooltip simple mostrado al pasar el ratón por el componente
is_super_tooltip_title
string
""
Título del tooltip enriquecido (prevalece sobre is_tooltip)
is_super_tooltip_text
string
""
Texto del tooltip enriquecido (se acepta el marcado enriquecido)
of_add_button (string as_key, string as_image_file, string as_text) → long
Agrega un botón de comando (id, archivo de imagen, etiqueta) al final de la barra. mono: en la imagen la recolorea al tema; una etiqueta vacía hace un botón solo icono. Devuelve 0, -5 con clave vacía o sin imagen ni texto
Estos miembros existen en todos los componentes visuales — no son propios de este. Se detallan una sola vez, en los capítulos transversales; esta tabla solo dice dónde leerlos.