scripts/stackedcycle.py

   1 ###########################################################################
   2 ### Functions for cycling focus (in a 'stacked' order) between windows. ###
   3 ###########################################################################
   4
   5 ###########################################################################
   6 ###    Options that affect the behavior of the stackedcycle module.     ###
   7 ###########################################################################
   8 INCLUDE_ALL_DESKTOPS = 0
   9 """If this is non-zero then windows from all desktops will be included in
  10    the stacking list."""
  11 INCLUDE_ICONS = 1
  12 """If this is non-zero then windows which are iconified will be included
  13    in the stacking list."""
  14 INCLUDE_OMNIPRESENT = 1
  15 """If this is non-zero then windows which are on all-desktops at once will
  16    be included."""
  17 TITLE_SIZE_LIMIT = 80
  18 """This specifies a rough limit of characters for the cycling list titles.
  19    Titles which are larger will be chopped with an elipsis in their
  20    center."""
  21 ACTIVATE_WHILE_CYCLING = 1
  22 """If this is non-zero then windows will be activated as they are
  23    highlighted in the cycling list (except iconified windows)."""
  24 # See focus.AVOID_SKIP_TASKBAR
  25 # See focuscycle.RAISE_WINDOW
  26 ###########################################################################
  27
  28 def next(data):
  29     """Focus the next window."""
  30     if not data.state:
  31         raise RuntimeError("stackedcycle.next must be bound to a key" +
  32                            "combination with at least one modifier")
  33     _o.cycle(data, 1)
  34
  35 def previous(data):
  36     """Focus the previous window."""
  37     if not data.state:
  38         raise RuntimeError("stackedcycle.previous must be bound to a key" +
  39                            "combination with at least one modifier")
  40     _o.cycle(data, 0)
  41
  42 ###########################################################################
  43 ###########################################################################
  44
  45 ###########################################################################
  46 ###      Internal stuff, should not be accessed outside the module.     ###
  47 ###########################################################################
  48
  49 import otk
  50 import ob
  51 import focus
  52 import focuscycle
  53
  54 class _cycledata:
  55     def __init__(self):
  56         self.cycling = 0
  57
  58     def createpopup(self):
  59         self.widget = otk.Widget(self.screen.number(), ob.openbox,
  60                                  otk.Widget.Vertical, 0, 1)
  61
  62     def destroypopup(self):
  63         self.menuwidgets = []
  64         self.widget = 0
  65
  66     def shouldadd(self, client):
  67         """Determines if a client should be added to the list."""
  68         curdesk = self.screen.desktop()
  69         desk = client.desktop()
  70
  71         if not client.normal(): return 0
  72         if not (client.canFocus() or client.focusNotify()): return 0
  73         if focus.AVOID_SKIP_TASKBAR and client.skipTaskbar(): return 0
  74
  75         if INCLUDE_ICONS and client.iconic(): return 1
  76         if INCLUDE_OMNIPRESENT and desk == 0xffffffff: return 1
  77         if INCLUDE_ALL_DESKTOPS: return 1
  78         if desk == curdesk: return 1
  79
  80         return 0
  81
  82     def populatelist(self):
  83         """Populates self.clients and self.menuwidgets, and then shows and
  84            positions the cycling popup."""
  85
  86         self.widget.hide()
  87
  88         try:
  89             current = self.clients[self.menupos]
  90         except IndexError: current = 0
  91         oldpos = self.menupos
  92         self.menupos = -1
  93
  94         # get the list of clients, keeping iconic windows at the bottom
  95         self.clients = []
  96         iconic_clients = []
  97         for c in focus._clients:
  98             if c.iconic(): iconic_clients.append(c)
  99             else: self.clients.append(c)
 100         self.clients.extend(iconic_clients)
 101
 102         # make the widgets
 103         i = 0
 104         self.menuwidgets = []
 105         while i < len(self.clients):
 106             c = self.clients[i]
 107             if not self.shouldadd(c):
 108                 # make the clients and menuwidgets lists match
 109                 self.clients.pop(i)
 110                 continue
 111
 112             w = otk.Label(self.widget)
 113             if current and c.window() == current.window():
 114                 self.menupos = i
 115                 w.setHighlighted(1)
 116                 pass
 117             else:
 118                 w.setHighlighted(0)
 119                 pass
 120             self.menuwidgets.append(w)
 121
 122             if c.iconic(): t = c.iconTitle()
 123             else: t = c.title()
 124             if len(t) > TITLE_SIZE_LIMIT: # limit the length of titles
 125                 t = t[:TITLE_SIZE_LIMIT / 2 - 2] + "..." + \
 126                     t[0 - TITLE_SIZE_LIMIT / 2 - 2:]
 127             w.setText(t)
 128
 129             i += 1
 130
 131         # the window we were on may be gone
 132         if self.menupos < 0:
 133             # try stay at the same spot in the menu
 134             if oldpos >= len(self.clients):
 135                 self.menupos = len(self.clients) - 1
 136             else:
 137                 self.menupos = oldpos
 138
 139         # find the size for the popup
 140         width = 0
 141         height = 0
 142         for w in self.menuwidgets:
 143             size = w.minSize()
 144             if size.width() > width: width = size.width()
 145             height += size.height()
 146
 147         # show or hide the list and its child widgets
 148         if len(self.clients) > 1:
 149             size = self.screeninfo.size()
 150             self.widget.resize(otk.Size(width, height))
 151             self.widget.move(otk.Point((size.width() - width) / 2,
 152                                        (size.height() - height) / 2))
 153             self.widget.show(1)
 154
 155     def activatetarget(self, final):
 156         try:
 157             client = self.clients[self.menupos]
 158         except IndexError: return # empty list makes for this
 159
 160         # move the to client's desktop if required
 161         if not (client.iconic() or client.desktop() == 0xffffffff or \
 162                 client.desktop() == self.screen.desktop()):
 163             root = self.screeninfo.rootWindow()
 164             ob.send_client_msg(root, otk.atoms.net_current_desktop,
 165                                root, client.desktop())
 166
 167         # send a net_active_window message for the target
 168         if final or not client.iconic():
 169             if final: r = focuscycle.RAISE_WINDOW
 170             else: r = 0
 171             ob.send_client_msg(self.screeninfo.rootWindow(),
 172                                otk.atoms.openbox_active_window,
 173                                client.window(), final, r)
 174
 175     def cycle(self, data, forward):
 176         if not self.cycling:
 177             ob.kgrab(data.screen, _grabfunc)
 178             # the pointer grab causes pointer events during the keyboard grab
 179             # to go away, which means we don't get enter notifies when the
 180             # popup disappears, screwing up the focus
 181             ob.mgrab(data.screen)
 182
 183             self.cycling = 1
 184             focus._disable = 1
 185             self.state = data.state
 186             self.screen = ob.openbox.screen(data.screen)
 187             self.screeninfo = otk.display.screenInfo(data.screen)
 188             self.menupos = 0
 189             self.createpopup()
 190             self.clients = [] # so it doesnt try start partway through the list
 191             self.populatelist()
 192
 193         if not len(self.clients): return # don't both doing anything
 194
 195         self.menuwidgets[self.menupos].setHighlighted(0)
 196         if forward:
 197             self.menupos += 1
 198         else:
 199             self.menupos -= 1
 200         # wrap around
 201         if self.menupos < 0: self.menupos = len(self.clients) - 1
 202         elif self.menupos >= len(self.clients): self.menupos = 0
 203         self.menuwidgets[self.menupos].setHighlighted(1)
 204         if ACTIVATE_WHILE_CYCLING:
 205             self.activatetarget(0) # activate, but dont deiconify/unshade/raise
 206
 207     def grabfunc(self, data):
 208         done = 0
 209         notreverting = 1
 210         # have all the modifiers this started with been released?
 211         if (data.action == ob.KeyAction.Release and
 212             not self.state & data.state):
 213             done = 1
 214         # has Escape been pressed?
 215         elif data.action == ob.KeyAction.Press and data.key == "Escape":
 216             done = 1
 217             notreverting = 0
 218             # revert
 219             self.menupos = 0
 220
 221         if done:
 222             self.cycling = 0
 223             focus._disable = 0
 224             # activate, and deiconify/unshade/raise
 225             self.activatetarget(notreverting)
 226             self.destroypopup()
 227             ob.kungrab()
 228             ob.mungrab()
 229
 230 def _newwindow(data):
 231     if _o.cycling: _o.populatelist()
 232
 233 def _closewindow(data):
 234     if _o.cycling: _o.populatelist()
 235
 236 def _grabfunc(data):
 237     _o.grabfunc(data)
 238
 239 ob.ebind(ob.EventAction.NewWindow, _newwindow)
 240 ob.ebind(ob.EventAction.CloseWindow, _closewindow)
 241
 242 _o = _cycledata()
 243
 244 print "Loaded stackedcycle.py"