KlassenKlassenKlassenKlassen | | | | Operatoren

create_tray_icon_imagecreate_tray_icon_imageCreateTrayIconImagecreate_tray_icon_imageCreateTrayIconImageCreateTrayIconImage (Operator)

Name

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

Signatur

create_tray_icon_image(Icon : : Tooltip, OptionalMessageQueue : TrayIconHandle)

Herror create_tray_icon_image(const Hobject Icon, const char* Tooltip, const Hlong OptionalMessageQueue, Hlong* TrayIconHandle)

Herror T_create_tray_icon_image(const Hobject Icon, const Htuple Tooltip, const Htuple OptionalMessageQueue, Htuple* TrayIconHandle)

Herror create_tray_icon_image(Hobject Icon, const HTuple& Tooltip, const HTuple& OptionalMessageQueue, Hlong* TrayIconHandle)

void CreateTrayIconImage(const HObject& Icon, const HTuple& Tooltip, const HTuple& OptionalMessageQueue, HTuple* TrayIconHandle)

void HNotificationX.CreateTrayIconImage(
[in] IHUntypedObjectX* Icon, [in] VARIANT Tooltip, [in] VARIANT OptionalMessageQueue, [out] VARIANT* TrayIconHandle)

static void HNotification.CreateTrayIconImage(HObject icon, HTuple tooltip, HTuple optionalMessageQueue, out HTuple trayIconHandle)

Beschreibung

create_tray_icon_imagecreate_tray_icon_imageCreateTrayIconImagecreate_tray_icon_imageCreateTrayIconImageCreateTrayIconImage zeigt ein Tray-Icon in der Traybar an.

Das Icon in IconIconIconIconIconicon muss ein Graustufenbild (1 Kanal) oder Farbbild (3 Kanäle) sein. Wir empfehlen eine Größe von 32x32.

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 in der Beschreibung von create_tray_iconcreate_tray_iconCreateTrayIconcreate_tray_iconCreateTrayIconCreateTrayIcon beschrieben.

Eine Variante dieses Operators, um vom Betriebssystem vorgegebene Icons in der Tray Bar anzuzeigen, gibt es als create_tray_iconcreate_tray_iconCreateTrayIconcreate_tray_iconCreateTrayIconCreateTrayIcon.

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.

Parallelisierung

Parameter

IconIconIconIconIconicon (input_object)  image(-array) objectHObjectHObjectHImageHObjectXHobject

An image to be shown as icon in the tray bar

TooltipTooltipTooltipTooltipTooltiptooltip (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

tooltip to be shown in tray bar

Defaultwert: 'title' "title" "title" "title" "title" "title"

OptionalMessageQueueOptionalMessageQueueOptionalMessageQueueOptionalMessageQueueOptionalMessageQueueoptionalMessageQueue (input_control)  message_queue HTupleHTupleHMessageQueue, HTupleVARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

optional HALCON message queue

Defaultwert: []

TrayIconHandleTrayIconHandleTrayIconHandleTrayIconHandleTrayIconHandletrayIconHandle (output_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

handle to the tray icon

Vorgänger

create_message_queuecreate_message_queueCreateMessageQueuecreate_message_queueCreateMessageQueueCreateMessageQueue

Nachfolger

clear_tray_iconclear_tray_iconClearTrayIconclear_tray_iconClearTrayIconClearTrayIcon, clear_all_tray_iconsclear_all_tray_iconsClearAllTrayIconsclear_all_tray_iconsClearAllTrayIconsClearAllTrayIcons

Alternativen

create_tray_iconcreate_tray_iconCreateTrayIconcreate_tray_iconCreateTrayIconCreateTrayIcon

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren