Operatoren |
create_tray_icon_image — Zeigt ein Tray-Icon in der Traybar an.
create_tray_icon_image(Icon : : Tooltip, OptionalMessageQueue : TrayIconHandle)
create_tray_icon_image zeigt ein Tray-Icon in der Traybar an.
Das Icon in Icon muss ein Graustufenbild (1 Kanal) oder Farbbild (3 Kanäle) sein. Wir empfehlen eine Größe von 32x32.
Der Text in Tooltip kann aufgrund von Beschränkungen des Betriebssystems maximal 127 Zeichen lang sein, längerer Text wird abgeschnitten.
In OptionalMessageQueue kann das Handle einer davor erzeugten Message-Queue (create_message_queue) übergeben werden. An diese Message-Queue werden dann Events der Traybar weitergegeben. Der Aufrufer muss sicherstellen, dass das Handle der Message Queue gültig bleibt solange das Tray-Icon in Benutzung ist, also bis clear_tray_icon aufgerufen wird. Mögliche Nachrichten sind in der Beschreibung von create_tray_icon beschrieben.
Eine Variante dieses Operators, um vom Betriebssystem vorgegebene Icons in der Tray Bar anzuzeigen, gibt es als create_tray_icon.
Mehr Informationen über das Notification Extension Package gibt es in der Einleitung zu diesem Kapitel.
Im Gegensatz zu HALCON-internen Handles können die Tray-Icons nicht automatisch gelöscht werden wenn das Programm in HDevelop zurückgesetzt wird (Taste F2). Es wird daher empfohlen den Operator clear_all_tray_icons manuell am Beginn jedes HDevelop-Skriptes einzubauen.
An image to be shown as icon in the tray bar
optional HALCON message queue
Defaultwert: []
handle to the tray icon
clear_tray_icon, clear_all_tray_icons
Foundation
Operatoren |