Tray Icon Widget

[ibigpapa]

Tray Icon Proposal

Tray Icons are usually used to show an application is running but not display a window. Sometimes the window is visible with the TrayIcon as well. The Icon also usually allows for a context menu to select some actions.

Proposed Properties

• TrayIcon.Icon
  • Description: Sets the Icon
  • Type: src.core.toga.widgets.icon
  • Access: RW
• TrayIcon.Title
  • Description: Sets the Title
  • Type: Str
  • Access: RW
• TrayIcon.Tooltip
  • Description: Sets the Tooltip (some platforms may not support this)
  • Type: Str (or New Widget)
  • Access: RW
• TrayIcon.Menu
  • Description: Adds a context menu widget
  • Type: ContextMenu (New Widget)
  • Access: RW

• Review all implementations to ensure Proposed abstraction is generic enough.
• Create a ContextMenu widget
• Create Implementation in Windows forms
• Create Implementation in MacOS
• Create Implementation in IOS
• Create Implementation in Android
• Create Implementation in GTK

Resources

• Windows:

  • .Net Windows.Forms.notifyIcon - https://msdn.microsoft.com/en-us/library/system.windows.forms.notifyicon(v=vs.110).aspx#Examples

• Mac OS:

  • NSStatusItem - https://developer.apple.com/documentation/appkit/nsstatusitem

• IOS:

  • 3d Touch(I belive this to be the better option limited to >= IPhone 6 ) - https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/Adopting3DTouchOniPhone/
  • NCWidgit - https://developer.apple.com/library/content/documentation/General/Conceptual/ExtensibilityPG/Today.html

• Android:

  • Applicaiton Shortcuts - https://developer.android.com/guide/topics/ui/shortcuts

• GTK:

  • StatusIcon - https://developer.gnome.org/gtk3/stable/GtkStatusIcon.html

[ibigpapa]

closing this one in favor of continuing thread on #97