buttonbar alinha uma fila de botões de comando — ícone, rótulo ou ambos — num único componente. Um clique reporta o id do botão (ue_clicked); cada botão é controlado por um handle (of_button) para o desativar, colorir ou ocultar. O componente a preferir assim que há vários botões: um WebView2 para toda a barra, onde N button separados custariam N.
▶ Ver ao vivo — Aplicação de demonstração, mosaico Button bar, com o código e 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
Recuo esquerdo/direito da barra, em pixels: o espaço antes do primeiro botão e depois do último. 0 cola os botões às bordas
ii_padding_y
integer
12
Recuo superior/inferior da barra, em pixels. Um botão PREENCHE a altura da barra: este recuo decide a altura dos botões (barra mais alta ou recuo menor = botões mais altos). 12 por predefinição; -1 = o do tema
ii_gap
integer
-1
Espaço ENTRE dois botões, em pixels. -1 (predefinição) = o do tema: um tema clássico junta os botões (com uma linha separadora), os outros separam-nos. 0 junta-os seja qual for o tema
is_align
string
end
Alinha a fila: start (esquerda), center, end (direita, predefinição, como uma caixa de diálogo) ou justify (botões de igual largura em toda a largura). Valores lógicos (RTL) — constantes ALIGN_*
is_default
string
""
Chave do botão predefinido — a ação principal, pintada com o acento, que Enter aciona (como o OK de uma caixa de diálogo). Vazio = nenhum; apenas um botão predefinido de cada vez
is_cancel
string
""
Chave do botão cancelar — o que Esc aciona (como o Cancelar de uma caixa de diálogo). Vazio = nenhum; apenas um botão cancelar de cada vez
is_theme_style
string
fluent
Estilo visual do componente (constantes THEME_STYLE_*)
is_theme_mode
string
light
Variante clara ou escura (constantes THEME_MODE_*)
il_theme_accent
long
-1
Cor de destaque deste componente (-1 = destaque do tema)
is_tooltip
string
""
Tooltip simples apresentado ao passar sobre o componente
is_super_tooltip_title
string
""
Título do tooltip enriquecido (prevalece sobre is_tooltip)
is_super_tooltip_text
string
""
Texto do tooltip enriquecido (aceita marcação enriquecida)
of_add_button (string as_key, string as_image_file, string as_text) → long
Adiciona um botão de comando (id, ficheiro de imagem, rótulo) no fim da barra. mono: na imagem recolore-a ao tema; um rótulo vazio faz um botão só ícone. Devolve 0, -5 com chave vazia ou sem imagem nem texto
Estes membros existem em todos os componentes visuais — não são próprios deste. São detalhados uma só vez, nos capítulos transversais; esta tabela apenas diz onde os ler.