|
|
KDE Dock Window class
This class implements dock windows.
A dock window is a small window (typically 24x24 pixel) that docks into 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.
When the user clicks with the left mouse button on the icon, the main application window is shown/raised and activated. With the right mouse button, she gets a popupmenu with application specific commands, including "Minimize/Restore" and "Quit".
Docking happens magically when calling show(). The window undocks with either hide() or when it is destroyed.
KDockWindow inherits methods such as setPixmap() and setMovie() to specify an icon or movie (animated icon) respectively. It is designed to be usable "as is", without the need to subclass it. In case you need to provide something special (such as an additional popupmenu on a click with the left mouse button), you can subclass anyway, of course.
Docking is a useful technique for daemon-like applications that may run for some time without user interaction but have to be there immediately when the user needs them. Examples are kppp, kisdn, kscd, kmix or knotes. With kppp and kisdn, the docked icon even provides real-time information about the network status.
|
Construct a KDockWindow widget just like any other widget.
The parent widget parent
has a special meaning:
Besides owning the dock window, the parent widget will
dissappear from taskbars when it is iconified while the dock
window is visible. This is the desired behaviour. After all,
the dock window @bf is the parent's taskbar icon.
Furthermore, the parent widget is shown or raised respectively when the user clicks on the dock window with the left mouse button.
void |
[protected]
Reimplemented to provide the standard show/raise behaviour for the parentWidget() and the context menu.
Feel free to reimplement this if you need something special.
void |
[protected]
Reimplemented to provide the standard show/raise behaviour for the parentWidget() and the context menu.
Feel free to reimplement this if you need something special.
KPopupMenu* |
[protected]
Access to the context menu. This makes it easy to add new items to it.
void |
[protected virtual]
Makes it easy to adjust some menu items right before the context menu becomes visible.
void |
[protected]
Reimplemented for internal reasons.