Die Toolbar-Klasse (Symbolleiste) leitet sich von der Area-Klasse ab und erstellt eine Leiste mit Bildschaltflächen, die normalerweise am oberen Rand eines Fensters platziert wird. Die Schaltflächen können in verschiedenen Ansichtsmodi angezeigt werden: Entweder als Bild, Bild und Text oder nur als Text. Normalerweise werden Schaltflächen in der Symbolleiste nur als Bilder angezeigt.
Wenn Sie ein Symbolleisten-Widget im XML-Code definieren, müssen Sie immer mindestens eine Symbolleistenschaltfläche hinzufügen. Dies geschieht mit der Toolbarbutton-Klasse (Symbolleistenschaltflächen). Hier ist eine Beispiel-XML-Definition einer Symbolleiste mit sechs Schaltflächen:
<toolbar> <button icon="1">Open</button> <button icon="2">Save</button> <button/> <button icon="3">Cut</button> <button icon="4">Copy</button> <button icon="5">Paste</button> <button/> <button icon="6">Help</button> </toolbar> |
In der obigen XML-Definition verwendet die Schaltfläche 1 in
der Symbolleiste den Hollywood-Pinsel 1 als Bild, Schaltfläche 2
den Pinsel 2 und so weiter. Beachten Sie die leeren <button/>-Definitionen:
Diese erzeugen Füll-Elemente, um eine zusammengehörende Gruppe
von Schaltflächen, optisch vom Rest der Schaltflächen zu trennen.
Symbolleisten-Schaltflächen können viele weitere Optionen wie
spezielle Bilder für ausgewählte und deaktivierte Zustände,
Tooltips und mehr verwenden. Siehe Toolbarbutton-Klasse für Details.
Es kann nur eine Symbolleiste pro Fenster geben und sie muss immer das erste Element der Wurzelgruppe des Fensters sein. RapaGUI akzeptiert keine Symbolleisten an beliebigen Positionen im GUI-Layout. Sie befinden sich also entweder oben (horizontale Symbolleisten) oder links vom Fenster (vertikale Symbolleisten).
Beachten Sie, dass es nicht möglich ist, eigenständige Instanzen dieser Klasse mit moai.CreateObject() zu erzeugen. Symbolleisten müssen immer im Kontext eines Fensters erstellt werden. Wenn Sie also Symbolleisten mit moai.CreateObject() erzeugen wollen, müssen Sie immer ein komplettes Fenster erstellen und die Symbolleiste in diese Fensterdefinition einbetten.
AmigaOS-Benutzer beachten bitte auch, dass diese Klasse die
Erweiterung TheBar.mcc benötigt.