create_tray_iconcreate_tray_iconCreateTrayIconcreate_tray_iconCreateTrayIconCreateTrayIcon (Operator)

Name

create_tray_iconcreate_tray_iconCreateTrayIconcreate_tray_iconCreateTrayIconCreateTrayIcon — Zeigt ein Tray-Icon in der Traybar an.

Signatur

create_tray_icon( : : Tooltip, StockIconName, OptionalMessageQueue : TrayIconHandle)

Beschreibung

create_tray_iconcreate_tray_iconCreateTrayIconcreate_tray_iconCreateTrayIconCreateTrayIcon zeigt ein Tray-Icon in der Traybar an.

Eine Übersicht über die möglichen vorgegebenen Iconnamen in StockIconNameStockIconNameStockIconNameStockIconNameStockIconNamestockIconName auf einem Windows-Betriebsystem gibt es unter: Windows Dev Center / SHSTOCKICONID enumeration Der Name in StockIconNameStockIconNameStockIconNameStockIconNameStockIconNamestockIconName muss ohne das SIID_-Präfix angegeben werden. Die Groß-/Kleinschreibung wird ignoriert. Beispielsweise 'ERROR' oder 'USERS' sind gültige Namen.

Hier folgt eine Liste der möglichen, von Windows vorgegebenen Icons. Bitte beachten Sie, dass nicht jede Betriebssystemversion jedes Icon unterstützt. Weiterhin sind die Icons 'heindlsolutions' und 'app' (das Icon der Hostapplikation, z.B. HDevelop) verfügbar:

'docnoassoc'' Document of a type with no associated application.
'docassoc'' Document of a type with an associated application.
'application'' Generic application with no custom icon.
'folder'' Folder (generic, unspecified state).
'folderopen'' Folder (open).
'drive525'' 5.25-inch disk drive.
'drive35'' 3.5-inch disk drive.
'driveremove'' Removable drive.
'drivefixed'' Fixed drive (hard disk).
'drivenet'' Network drive (connected).
'drivenetdisabled'' Network drive (disconnected).
'drivecd'' CD drive.
'driveram'' RAM disk drive.
'world'' The entire network.
'server'' A computer on the network.
'printer'' A local printer or print destination.
'mynetwork'' The 'Network'' virtual folder.
'find'' The 'Search'' feature.
'help'' The 'Help and Support'' feature.
'share'' Overlay for a shared item.
'link'' Overlay for a shortcut.
'slowfile'' Overlay for items that are expected to be slow to access.
'recycler'' The Recycle Bin (empty).
'recyclerfull'' The Recycle Bin (not empty).
'mediacdaudio'' Audio CD media.
'lock'' Security lock.
'autolist'' A virtual folder that contains the results of a search.
'printernet'' A network printer.
'servershare'' A server shared on a network.
'printerfax'' A local fax printer.
'printerfaxnet'' A network fax printer.
'printerfile'' A file that receives the output of a 'Print to file'' operation.
'stack'' A category that results from a 'Stack by'' command to organize the contents of a folder.
'mediasvcd'' Super Video CD (SVCD) media.
'stuffedfolder'' A folder that contains only subfolders as child items.
'driveunknown'' Unknown drive type.
'drivedvd'' DVD drive.
'mediadvd'' DVD media.
'mediadvdram'' DVD-RAM media.
'mediadvdrw'' DVD-RW media.
'mediadvdr'' DVD-R media.
'mediadvdrom'' DVD-ROM media.
'mediacdaudioplus'' CD+ (enhanced audio CD) media.
'mediacdrw'' CD-RW media.
'mediacdr'' CD-R media.
'mediacdburn'' A writeable CD in the process of being burned.
'mediablankcd'' Blank writable CD media.
'mediacdrom'' CD-ROM media.
'audiofiles'' An audio file.
'imagefiles'' An image file.
'videofiles'' A video file.
'mixedfiles'' A mixed file.
'folderback'' Folder back.
'folderfront'' Folder front.
'shield'' Security shield.
'warning'' Warning.
'info'' Informational.
'error'' Error.
'key'' Key.
'software'' Software.
'rename'' A UI item, such as a button, that issues a rename command.
'delete'' A UI item, such as a button, that issues a delete command.
'mediaaudiodvd'' Audio DVD media.
'mediamoviedvd'' Movie DVD media.
'mediaenhancedcd'' Enhanced CD media.
'mediaenhanceddvd'' Enhanced DVD media.
'mediahddvd'' High definition DVD media in the HD DVD format.
'mediabluray'' High definition DVD media in the Blu-ray Disc format.
'mediavcd'' Video CD (VCD) media.
'mediadvdplusr'' DVD+R media.
'mediadvdplusrw'' DVD+RW media.
'desktoppc'' A desktop computer.
'mobilepc'' A mobile computer (laptop).
'users'' The 'User Accounts'' Control Panel item.
'mediasmartmedia'' Smart media.
'mediacompactflash'' CompactFlash media.
'devicecellphone'' A cell phone.
'devicecamera'' A digital camera.
'devicevideocamera'' A digital video camera.
'deviceaudioplayer'' An audio player.
'networkconnect'' Connect to network.
'internet'' The 'Network and Internet'' Control Panel item.
'zipfile'' A compressed file with a .zip file name extension.
'settings'' The 'Additional Options'' Control Panel item.
'drivehddvd'High definition DVD drive (any type - HD DVD-ROM, HD DVD-R, HD-DVD-RAM) that uses the HD DVD format.
'drivebd'High definition DVD drive (any type - BD-ROM, BD-R, BD-RE) that uses the Blu-ray Disc format.
'mediahddvdrom'High definition DVD-ROM media in the HD DVD-ROM format.
'mediahddvdr'High definition DVD-R media in the HD DVD-R format.
'mediahddvdram'High definition DVD-RAM media in the HD DVD-RAM format.
'mediabdrom'High definition DVD-ROM media in the Blu-ray Disc BD-ROM format.
'mediabdr'High definition write-once media in the Blu-ray Disc BD-R format.
'mediabdre'High definition read/write media in the Blu-ray Disc BD-RE format.
'clustereddrive'A cluster disk array.
'heindlsolutions' Icon Heindl Solutions: Das Firmenlogo von Heindl Solutions.
'app' - Standard-Icon der Wirtsanwendung, z.B. das Icon der hdevelop.exe-Datei, kann aber auch ein anderes Icon sein wenn dieses Extension Package innerhalb eines anderen Executables ausgeführt wird.

Der Text in TooltipTooltipTooltipTooltipTooltiptooltip kann aufgrund von Beschränkungen des Betriebssystems maximal 127 Zeichen lang sein, längerer Text wird abgeschnitten.

In OptionalMessageQueueOptionalMessageQueueOptionalMessageQueueOptionalMessageQueueOptionalMessageQueueoptionalMessageQueue kann das Handle einer davor erzeugten Message-Queue (create_message_queuecreate_message_queueCreateMessageQueuecreate_message_queueCreateMessageQueueCreateMessageQueue) ü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_iconclear_tray_iconClearTrayIconclear_tray_iconClearTrayIconClearTrayIcon aufgerufen wird. Mögliche Nachrichten sind:

Key: 'tray_icon_select', TupleData: TrayIconHandle

Key: 'tray_balloon_click', TupleData: TrayIconHandle

Key: 'tray_context_menu_select', TupleData: TrayIconHandle, Key 2: 'tray_context_menu_index', TupleData: zero-based index of the context menu entry as set in operator set_tray_icon_context_menuset_tray_icon_context_menuSetTrayIconContextMenuset_tray_icon_context_menuSetTrayIconContextMenuSetTrayIconContextMenu for parameter MenuStructure.

Eine Variante dieses Operators, um eigene Icons aus HALCON-Bildern in der Tray Bar anzuzeigen, gibt es als create_tray_icon_imagecreate_tray_icon_imageCreateTrayIconImagecreate_tray_icon_imageCreateTrayIconImageCreateTrayIconImage.

Mehr Informationen über das Notification Extension Package gibt es in der Einleitung zu diesem Kapitel.

Achtung

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_iconsclear_all_tray_iconsClearAllTrayIconsclear_all_tray_iconsClearAllTrayIconsClearAllTrayIcons manuell am Beginn jedes HDevelop-Skriptes einzubauen.