Die Komponente gb.gui.trayicon ermöglicht es, ein Tray-Icon in der Taskleiste anzuzeigen. Es werden die folgenden System-Tray-Protokolle unterstützt:
Das DBus-Systemprotokoll sollte Standard sein, aber leider sind KDE- und Ubuntu-Implementierungen nicht miteinander kompatibel! Die Komponente untersucht daher zur Laufzeit, welche Art von System-Tray auf dem System verfügbar ist. Danach wird automatisch das passende Protokoll gewählt. Die Komponente gb.dbus wird nur dann geladen, wenn auch das DBus-Protokoll verwendet wird.
Während die Klasse TrayIcon ein Tray-Icon implementiert, stellt die Klasse TrayIcons eine virtuelle Sammlung aller TrayIcon-Objekte zu Verfügung, die von einer Anwendung verwaltet werden.
Die Klasse TrayIcon verfügt über diese Eigenschaften:
19.2.1.1 Eigenschaften
| Eigenschaft | Datentyp | Beschreibung |
|---|---|---|
| Icon | Picture | Gibt das Symbol zurück oder setzt das Symbol für das Tray-Icon. |
| Picture | Picture | Ein Synonym für die Icon-Eigenschaft. |
| PopupMenu | String | Der Name des Menüs wird gesetzt oder zurück gegeben, wenn ein Nutzer auf das Tray-Icon klickt. |
| Tag | Variant | Gibt den Wert der Tag-Eigenschaft zurück oder setzt den Wert dieser Eigenschaft. Diese Eigenschaft ist für den Programmierer bestimmt und wird von der Komponente nie verwendet. Tag kann einen beliebigen Wert vom Typ Variant annehmen. |
| ToolTip | String | Gibt den Text des Tool-Tipps zurück oder setzt den Text des Tool-Tipps, der für das Tray-Icon angezeigt wird. |
| Text | String | Ein Synonym für die Tooltip-Eigenschaft. |
| Visible | Boolean | Gibt an, ob das Tray-Icon sichtbar ist oder legt mit True fest, dass das Tray-Icon sichtbar ist. |
Tabelle 19.2.1.1.1: Eigenschaften der Klasse TrayIcon
Die Klasse TrayIcon besitzt nur drei Methoden:
| Methode | Beschreibung |
|---|---|
| Delete( ) | Löscht ein TrayIcon-Objekt. |
| Hide() | Blendet das Tray-Icon aus dem System-Tray aus. |
| Show() | Zeigt das Tray-Icon im System-Tray an. |
Tabelle 19.2.1.2.1: Methoden der Klasse TrayIcon
Hinweis:
Wenn Sie das Fenster einer Anwendung schließen wollen, die ein TrayIcon-Objekt verwendet, dann müssen Sie vorher die Methode TrayIcon.Hide() verwenden!
Nur drei Ereignisse werden durch die Klasse TrayIcon ausgelöst:
| Ereignis | Beschreibung |
|---|---|
| Click | Dieses Ereignis wird ausgelöst, wenn der Benutzer mit der linken Maustaste auf das Tray-Icon klickt. |
| MiddleClick | Dieses Ereignis wird ausgelöst, wenn der Benutzer mit der mittleren Maustaste auf das Tray-Icon klickt. |
| Scroll ( Delta As Float, Orientation As Integer ) | Dieses Ereignis wird ausgelöst, wenn der Benutzer mit der Maus auf dem Tray-Icon scrollt. |
Tabelle 19.2.1.3.1: Ereignisse der Klasse TrayIcon
Hinweise zum Scroll(…)-Ereignis
Im Kapitel 13.6 Kontextmenü – TrayIcon finden Sie ein Projekt, dass ausgewählte Eigenschaften, Methoden und Ereignisse der Klasse TrayIcon einsetzt.
19.2.2 Klasse TrayIcons
Diese Klasse implementiert eine virtuelle Sammlung aller TrayIcon-Objekte, die von einer Anwendung verwaltet werden. Diese Klasse verhält sich wie eine Nur-Lese-Klasse.
Dim hTrayIcon As TrayIcon hTrayIcon = TrayIcons [ Index As Integer ]
Über alle TrayIcon-Objekte kann mit dem Schlüsselwort-Paar „For Each“ iteriert werden:
Dim hTrayIcon As TrayIcon For Each hTrayIcon In TrayIcons ... Next
Während die Eigenschaft TrayIcons.Count die Anzahl der von einer Anwendung verwalteten TrayIcon-Objekte zurück gibt, löscht die einzige Methode TrayIcons.DeleteAll() der Klasse TrayIcons alle TrayIcon-Objekte.