set_tray_icon_context_menuset_tray_icon_context_menuSetTrayIconContextMenuset_tray_icon_context_menuSetTrayIconContextMenuSetTrayIconContextMenu (Operator)

Name

set_tray_icon_context_menuset_tray_icon_context_menuSetTrayIconContextMenuset_tray_icon_context_menuSetTrayIconContextMenuSetTrayIconContextMenu — Setzt ein Kontextmenü für das Tray-Icon

Signatur

set_tray_icon_context_menu( : : TrayIconHandle, MenuStructure : )

set_tray_icon_context_menuset_tray_icon_context_menuSetTrayIconContextMenuset_tray_icon_context_menuSetTrayIconContextMenuSetTrayIconContextMenu Setzt ein Kontextmenü für das Tray-Icon. Das Kontextmenü für das Tray Icon wird über den Parameter MenuStructureMenuStructureMenuStructureMenuStructureMenuStructuremenuStructure definiert. Jeder String-Eintrag im Tupel MenuStructureMenuStructureMenuStructureMenuStructureMenuStructuremenuStructure führt zu einem Eintrag im Kontextmenü. Sub-Menüs können über eine Einrückung durch zwei Leerzeichen erzeugt werden, ein Separator wird über den Text '-' definiert. Häckchen bzw. explizit nicht-abgehakte Einträge werden über Präfixe '[x] ' und '[ ] ' erzeugt.

Um das Ereignis abrufen zu können, dass ein Eintrag im Kontextmenü gewählt wurde, muss das Tray-Icon in create_tray_iconcreate_tray_iconCreateTrayIconcreate_tray_iconCreateTrayIconCreateTrayIcon oder create_tray_icon_imagecreate_tray_icon_imageCreateTrayIconImagecreate_tray_icon_imageCreateTrayIconImageCreateTrayIconImage mit einer Message-Queue erzeugt werden. Aus dieser Message-Queue können dann Nachrichten mit dem Operator dequeue_messagedequeue_messageDequeueMessagedequeue_messageDequeueMessageDequeueMessage entnommen werden. Mögliche Nachrichten sind in der Beschreibung von create_tray_iconcreate_tray_iconCreateTrayIconcreate_tray_iconCreateTrayIconCreateTrayIcon beschrieben.

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

Parallelisierung

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

TrayIconHandleTrayIconHandleTrayIconHandleTrayIconHandleTrayIconHandletrayIconHandle (input_control) integer → (integer)

handle to the tray icon

MenuStructureMenuStructureMenuStructureMenuStructureMenuStructuremenuStructure (input_control) string(-array) → (string)

context menu structure

Defaultwert: ['entry1','entry2'] ["entry1","entry2"] ["entry1","entry2"] ["entry1","entry2"] ["entry1","entry2"] ["entry1","entry2"]

Beispiel (HDevelop)

  create_message_queue (MessageQueueHandle)
  create_tray_icon ('tooltip', 'folderopen', MessageQueueHandle, TrayIconHandle1)
  MenuStructure := \
                   [ 'entry1' \
                    ,'  [ ] subentry1' \
                    ,'  [X] subentry2' \
                    ,'    subsubentry21' \
                    ,'entry2' \
                    ,'-' \
                    ,'-' \
                    ,'entry3' \
                    ,'-' \
                    ,'entry4' \
  ]
  set_tray_icon_context_menu (TrayIconHandle, MenuStructure)

Vorgänger

create_tray_iconcreate_tray_iconCreateTrayIconcreate_tray_iconCreateTrayIconCreateTrayIcon, create_tray_icon_imagecreate_tray_icon_imageCreateTrayIconImagecreate_tray_icon_imageCreateTrayIconImageCreateTrayIconImage

Modul

Foundation

Operatoren