Development/Architecture/KDE3/System Tray Docking - Revision history

Neverendingo: Text replace - "" to ""

2011-06-29T20:49:39Z

Text replace - "</code>" to "</syntaxhighlight>"

Neverendingo: Text replace - "`" to ""`


2011-06-29T20:35:21Z
Text replace - "<code cppqt3>" to "<syntaxhighlight lang="cpp-qt">"

				
				
				
				
			
			← Older revision
			Revision as of 20:35, 29 June 2011
			
Line 28:
Line 28:
  The following code can be used to declare a window a tray window:   The following code can be used to declare a window a tray window:
    
− <code cppqt3> + <syntaxhighlight lang="cpp-qt">
  /** Prototypes:   /** Prototypes:
       Display dpy;        Display dpy;



Dhaumann: Development/Architecture/KDE 3 Architecture/System Tray Docking moved to Development/Architecture/KDE3/System Tray Docking
2007-03-11T21:38:31Z
Development/Architecture/KDE 3 Architecture/System Tray Docking moved to Development/Architecture/KDE3/System Tray Docking

			
			← Older revision
			Revision as of 21:38, 11 March 2007
			


Dhaumann: Category:KDE3
Category:Architecture
2007-01-23T09:43:03Z
Category:KDE3 Category:Architecture

				
				
				
				
			
			← Older revision
			Revision as of 09:43, 23 January 2007
			
Line 8:
Line 8:
  application, similar to a taskbar button, but consumes less screen   application, similar to a taskbar button, but consumes less screen
  space.   space.
−  
    
  This page contains just the raw protocol description. More   This page contains just the raw protocol description. More
Line 45:
Line 44:
  <tt>XUnmapWindow()</tt> or <tt>XDestroyWindow()</tt>.   <tt>XUnmapWindow()</tt> or <tt>XDestroyWindow()</tt>.
    
− == From the windowmanager's  point of view == + == From the windowmanager's point of view ==
    
  TODO (once it is done)   TODO (once it is done)
  {{improve}}   {{improve}}
    
− == From the docking-container's  point of view == + == From the docking-container's point of view ==
    
  TODO (once it is done)   TODO (once it is done)
Line 56:
Line 55:
    
  ''Initial Author:'' [mailto:ettrich@kde.org Matthias Ettrich]   ''Initial Author:'' [mailto:ettrich@kde.org Matthias Ettrich]
  + 
  + [[Category:KDE3]]
  + [[Category:Architecture]]



Dhaumann: port http://developer.kde.org/documentation/library/kdeqt/kde3arch/protocols-docking.html
2007-01-11T16:48:00Z
port http://developer.kde.org/documentation/library/kdeqt/kde3arch/protocols-docking.html
New page
'''KDE Architecture - System Tray Docking Protocol'''



== The KDE System Tray Docking Protocol ==



A tray window is a small window (typically 24x24 pixel) that docks

into the system tray in the desktop panel. It usually displays an icon

or an animated icon there. The icon serves as representative for the

application, similar to a taskbar button, but consumes less screen

space.





This page contains just the raw protocol description. More

information on the system tray itself and how to use it with KDE

applications can be found in the section [[../Docking Into the Panel's System Tray|Components/SystemTrayDocking]] of this

architecture overview.



== From the application's point of view ==



For the application, a tray window is just another toplevel window

with one special property defined. The property is called

<tt>_KDE_NET_SYSTEM_TRAY_WINDOW_FOR</tt> and is of type

<tt>XA_WINDOW</tt>, format 32.



The pure existence of this property indicates that the window

manager should treat this window as a tray window. The property value

may further define the tray window's main window, i.e. the window

the tray window is representing.



The following code can be used to declare a window a tray window:



<code cppqt3>

/** Prototypes:

    Display dpy;

    Window trayWin, forWin;

*/

Atom kde_net_wm_system_tray_window_for =

  XInternAtom( dpy, "_KDE_NET_WM_SYSTEM_TRAY_WINDOW_FOR", False);

XChangeProperty( dpy, trayWin, kde_net_wm_system_tray_window_for,

                 XA_WINDOW, 32, PropModeReplace,

                 (unsigned char *)&amp;forWin, 1);

</code>



When the application maps the window with <tt>XMapWindow()</tt>,

the window will dock into a system tray  if possible. Undocking is done with either

<tt>XUnmapWindow()</tt> or <tt>XDestroyWindow()</tt>.



== From the windowmanager's  point of view ==



TODO (once it is done)

{{improve}}



== From the docking-container's  point of view ==



TODO (once it is done)





''Initial Author:'' [mailto:ettrich@kde.org Matthias Ettrich]

Development/Architecture/KDE3/System Tray Docking - Revision history

Neverendingo: Text replace - "" to ""

Neverendingo: Text replace - "" to ""

Dhaumann: Development/Architecture/KDE 3 Architecture/System Tray Docking moved to Development/Architecture/KDE3/System Tray Docking

Dhaumann: Category:KDE3 Category:Architecture

Dhaumann: port http://developer.kde.org/documentation/library/kdeqt/kde3arch/protocols-docking.html

Neverendingo: Text replace - "`" to ""`