Projects/Plasma/NewSystemTray: Difference between revisions

    From KDE TechBase
    No edit summary
    Line 71: Line 71:


    ==== 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]
    [http://websvn.kde.org/trunk/playground/base/plasma/libknotificationicon/org.kde.SystemTray.xml Websvn link]

    Revision as of 12:51, 26 February 2009

    New System Tray Design

    Categories

    System tray icons generally fall into four categories:

    • Indicators of application status
    • Communications
    • System services
    • Hardware

    Properties

    A System Tray Icon will Have the following 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

    Signals

    - i have a new pixmap

    - i have a new status

    the host will react to these, but with no guarantee of when - expect 500ms.

    Slots

    - activated

    Properties

    - tooltip data

    - name

    - pixmap

    Draft of the D-Bus xml service description

    Websvn link