summaryrefslogtreecommitdiffstats
path: root/kicker/extensions/kasbar/DESIGN
blob: c107a4cb643df07ee3cbf4dbd471761345cdee0f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
KasBar TNG Design
=================

In order to support both the various features people asked for when I
discussed Kasbar on dot.kde.org without ending up with a completely
unmaintainable application, I've decided to rewrite the code. It's a
fairly small application, so this isn't a big deal. The task management
side of things (interacting with the window manager etc.) is now handled
via the standard TaskManager API provided by kicker.

The division of labour between the classes is like this:

* KasBar, KasItem, KasPopup

  These classes implement the KasBar widget. KasBar provides the
  tqlayout and smart redraws while the KasItem class is an abstract
  interface for the items forming the bars contents. The KasPopup
  class provides a self positioning widget that should be subclassed
  to provide useful information.

  These classes are usable standalone.

* KasTasker, KasTaskItem, KasTaskPopup

  These classes provide the glue linking the task management and
  karbar modules together.

* KasGroupItem, KasGroupPopup

  These class provide a container item for a group of tasks, and popup
  window that shows them in a KasTasker widget.

* KasBarExtension

  This class handles integration with kicker and configuration info.

* KasPrefsDlg

  This is the configuration dialog. It acts directly on the kastasker
  widget to provide immediate feedback of the effects of configuration
  changes. Any changes being previewed are reverted if the user cancels
  the dialog because the configuration is reloaded.