buttonbar ordnet eine Reihe von Befehlsschaltflächen — Symbol, Beschriftung oder beides — in einer Komponente an. Ein Klick meldet die Button-Id (ue_clicked); jeder Button wird über ein Handle (of_button) gesteuert, um ihn zu deaktivieren, zu färben oder auszublenden. Die zu bevorzugende Komponente, sobald es mehrere Schaltflächen gibt: ein WebView2 für die ganze Leiste statt N einzelner button.
▶ Live sehen — Demoanwendung, Kachel Button bar, mit dem Code und dieser Seite nebeneinander.
// 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
Linker/rechter Abstand der Leiste, in Pixeln: der Raum vor der ersten und nach der letzten Schaltfläche. 0 drückt die Schaltflächen an die Ränder
ii_padding_y
integer
12
Oberer/unterer Abstand der Leiste, in Pixeln. Eine Schaltfläche FÜLLT die Höhe der Leiste: dieser Abstand bestimmt also die Höhe der Schaltflächen (höhere Leiste oder kleinerer Abstand = höhere Schaltflächen). Standard 12; -1 = der des Designs
ii_gap
integer
-1
Abstand ZWISCHEN zwei Schaltflächen, in Pixeln. -1 (Standard) = der des Designs: ein klassisches Design fügt die Schaltflächen zusammen (mit Trennlinie), die anderen trennen sie. 0 fügt sie in jedem Design zusammen
is_align
string
end
Richtet die Reihe aus: start (links), center, end (rechts, Standard, wie ein Dialog) oder justify (gleich breite Schaltflächen über die ganze Breite). Logische (RTL-fähige) Werte — Konstanten ALIGN_*
is_default
string
""
Schlüssel der Standard-Schaltfläche — die primäre Aktion, mit dem Akzent gefärbt, die Enter auslöst (wie das OK eines Dialogs). Leer = keine; immer nur eine Standardschaltfläche
is_cancel
string
""
Schlüssel der Abbrechen-Schaltfläche — diejenige, die Esc auslöst (wie das Abbrechen eines Dialogs). Leer = keine; immer nur eine Abbrechen-Schaltfläche
is_theme_style
string
fluent
Visueller Stil der Komponente (Konstanten THEME_STYLE_*)
is_theme_mode
string
light
Helle oder dunkle Variante (Konstanten THEME_MODE_*)
il_theme_accent
long
-1
Akzentfarbe dieser Komponente (-1 = Akzent des Designs)
is_tooltip
string
""
Einfacher Tooltip beim Überfahren der Komponente
is_super_tooltip_title
string
""
Titel des erweiterten Tooltips (hat Vorrang vor is_tooltip)
is_super_tooltip_text
string
""
Text des erweiterten Tooltips (Rich-Markup zulässig)
of_add_button (string as_key, string as_image_file, string as_text) → long
Fügt am Ende der Leiste eine Befehlsschaltfläche hinzu (Id, Bilddatei, Beschriftung). mono: färbt das Bild aufs Design um; leere Beschriftung ergibt eine Nur-Symbol-Schaltfläche. Liefert 0, -5 bei leerem Schlüssel oder ohne Bild und Text
Fügt eine Befehlsschaltfläche an Position ai_index (1-basiert) ein und verschiebt die übrigen. Liefert 0, -5 bei leerem Schlüssel oder ohne Bild und Text
of_remove_button (string as_key) → long
Entfernt eine Schaltfläche über ihren Schlüssel; die übrigen behalten ihren Zustand. Liefert 0, -5 bei leerem Schlüssel
of_move_button (string as_key, integer ai_index) → long
Verschiebt eine Schaltfläche an Position ai_index (1-basiert), ohne ihren Zustand zu verlieren. Liefert 0, -5 bei leerem Schlüssel
of_clear_buttons ( ) → long
Entfernt alle Schaltflächen der Leiste. Liefert 0, -2 wenn nicht erzeugt
Aktiviert oder deaktiviert eine Schaltfläche; deaktiviert nicht klickbar
ib_visible
boolean
true
Zeigt oder verbirgt eine Schaltfläche; verborgen behält sie ihren Platz und kehrt zurück
is_text
string
""
Beschriftung der Schaltfläche; nach dem Hinzufügen änderbar
is_image
string
""
Symbol der Schaltfläche (Bilddatei; mono: folgt dem Design); nach dem Hinzufügen änderbar
il_badge
long
0
Kleines Zähler-Badge in der Ecke der Schaltfläche (0 = keins)
is_shortcut
string
""
Mnemonik dieser Schaltfläche: Alt+der Buchstabe löst sie aus, und der Buchstabe wird in der Beschriftung unterstrichen. Ein Buchstabe (der erste wird verwendet); leer = keine
il_back_color
long
-1
Hintergrund DIESER Schaltfläche (-1 = der der Komponente, folgt dem Design)
il_text_color
long
-1
Textfarbe DIESER Schaltfläche (-1 = die der Komponente)
il_back_color_hover
long
-1
Hintergrund DIESER Schaltfläche beim Überfahren (-1 = der der Komponente)
il_text_color_hover
long
-1
Textfarbe DIESER Schaltfläche beim Überfahren (-1 = die der Komponente)
il_accent
long
-1
Akzent DIESER Schaltfläche (-1 = Akzent der Komponente)
Diese Mitglieder gibt es bei jeder visuellen Komponente — sie sind nicht dieser eigen. Sie werden einmal in den übergreifenden Kapiteln beschrieben; diese Tabelle sagt nur, wo man sie liest.