Projects/Plasma/NewSystemTray: Difference between revisions
(some examples for the categories) |
(more on the host) |
||
| Line 41: | Line 41: | ||
=== Client === | === 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. | 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. | ||
=== 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 ==== | ==== Signals ==== | ||
The client can signal the following to the host in order to change appearance and status: | |||
* i have a new pixmap | * i have a new pixmap | ||
* i have a new status | * i have a new status | ||
==== Slots ==== | ==== Slots ==== | ||
The Host (system tray) can call the following slots in the application: | |||
* activated | * activated | ||
==== Properties ==== | ==== Properties ==== | ||
The Host queries the client for the following properties: | |||
* tooltip data | * tooltip data | ||
* name | * name | ||
Revision as of 19:39, 26 February 2009
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.
Properties
A System Tray Icon 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' ie the icon itself, and the 'Host' eg. 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.
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 client can signal the following to the host in order to change appearance and status:
- i have a new pixmap
- i have a new status
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