< Projects Revision as of 01:24, 27 February 2009 (view source)Sebas (talk | contribs) (more clarifications)← Older edit Revision as of 01:28, 27 February 2009 (view source) Sebas (talk | contribs) (add link to whiteboard photo)Newer edit → Line 63: Line 63: = Draft of the D-Bus xml service description = = Draft of the D-Bus xml service description = [http://websvn.kde.org/trunk/playground/base/plasma/libknotificationicon/org.kde.SystemTray.xml Websvn link] [http://websvn.kde.org/trunk/playground/base/plasma/libknotificationicon/org.kde.SystemTray.xml Websvn link] + +[http://vizzzion.org/stuff/systray-whiteboard.jpg Whiteboard at TokamakII] Revision as of 01:28, 27 February 2009 Contents 1 New System Tray Design 1.1 Categories 1.2 Properties 1.3 Interactions 1.3.1 Client 1.3.2 Host 126.96.36.199 Signals 188.8.131.52 Slots 184.108.40.206 Properties 2 Draft of the D-Bus xml service description New System Tray Design Categories System tray icons generally fall into four categories: Indicators of application status Communications System services Hardware Applications registering with the system tray provide one of those categories. An Instant Messaging application or an Email client will fall into 'Communications'. System services are for example software update notifications. Examples for Hardware are a battery monitor a mixer or a Network Management applet. Applications that use the system tray for freeing space in the taskbar use the Application Status category. The system tray implementation can choose to provide the information delivered by the client application in different ways. Properties A System Tray Item will Have the following elements and properties. Icon name pixmap (possible size variants) Tooltip Headline Subtext Pixmap Status Passive (normal) Active Needs Attention Interaction Context menu Activate Wheel up/down Interactions The interactions can be considered in terms of the 'Client' i.e. the icon itself, and the 'Host' e.g. the system tray. Client A client of the system tray is an application that registers with the system tray to display its information. The system tray (the host) reacts to signals it receives from the client. The host also can pass back an action to the client application, for example when the application has been activated. The host receives the signals in an asynchronous fashion from the client. The display of the message might happen delayed. Host The Host is the system tray itself. It offers an interface for applications to register in a standardized way, acts on signals sent by these clients, and can do callbacks to the client application (for example to activate a window when the icon has been clicked). Signals The application can signal the following to the system tray host in order to change appearance and status of the icon: A new pixmap is available The status changed Slots The Host (system tray) can call the following slots in the application: activated Properties The Host queries the client for the following properties: tooltip data name pixmap Draft of the D-Bus xml service description Websvn link Whiteboard at TokamakII Retrieved from "https://techbase.kde.org/index.php?title=Projects/Plasma/NewSystemTray&oldid=39033" Content is available under Creative Commons License SA 4.0 unless otherwise noted.