import otk
StateRemove = 0
+"""For the state_* callbacks. Indicates the state should be removed from the
+ window."""
StateAdd = 1
+"""For the state_* callbacks. Indicates the state should be add to the
+ window."""
StateToggle = 2
-
-def restart(data=0, other = ""):
- """Restarts Openbox, optionally starting another window manager."""
- ob.openbox.restart(other)
-
-def exit(data=0):
- """Exits Openbox."""
- ob.openbox.shutdown()
+"""For the state_* callbacks. Indicates the state should be toggled on the
+ window."""
def state_above(data, add=StateAdd):
"""Toggles, adds or removes the 'above' state on a window.
StateToggle."""
if not data.client: return
ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(),
- otk.Property_atoms().net_wm_state, data.client.window(),
- add, otk.Property_atoms().net_wm_state_above)
+ otk.atoms.net_wm_state, data.client.window(),
+ add, otk.atoms.net_wm_state_above)
def state_below(data, add=StateAdd):
"""Toggles, adds or removes the 'below' state on a window.
StateToggle."""
if not data.client: return
ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(),
- otk.Property_atoms().net_wm_state, data.client.window(),
- add, otk.Property_atoms().net_wm_state_below)
+ otk.atoms.net_wm_state, data.client.window(),
+ add, otk.atoms.net_wm_state_below)
def state_shaded(data, add=StateAdd):
"""Toggles, adds or removes the 'shaded' state on a window.
StateToggle."""
if not data.client: return
ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(),
- otk.Property_atoms().net_wm_state, data.client.window(),
- add, otk.Property_atoms().net_wm_state_shaded)
+ otk.atoms.net_wm_state, data.client.window(),
+ add, otk.atoms.net_wm_state_shaded)
def state_maximize(data, add=StateAdd):
"""Toggles, adds or removes the horizontal and vertical 'maximized' state
or StateToggle."""
if not data.client: return
ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(),
- otk.Property_atoms().net_wm_state, data.client.window(),
- add, otk.Property_atoms().net_wm_state_maximized_horz,
- otk.Property_atoms().net_wm_state_maximized_vert)
+ otk.atoms.net_wm_state, data.client.window(),
+ add, otk.atoms.net_wm_state_maximized_horz,
+ otk.atoms.net_wm_state_maximized_vert)
def state_maximize_horz(data, add=StateAdd):
"""Toggles, adds or removes the horizontal 'maximized' state on a window.
StateToggle."""
if not data.client: return
ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(),
- otk.Property_atoms().net_wm_state, data.client.window(),
- add, otk.Property_atoms().net_wm_state_maximized_horz)
+ otk.atoms.net_wm_state, data.client.window(),
+ add, otk.atoms.net_wm_state_maximized_horz)
def state_maximize_vert(data, add=StateAdd):
"""Toggles, adds or removes the vertical 'maximized' state on a window.
StateToggle."""
if not data.client: return
ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(),
- otk.Property_atoms().net_wm_state, data.client.window(),
- add, otk.Property_atoms().net_wm_state_maximized_vert)
+ otk.atoms.net_wm_state, data.client.window(),
+ add, otk.atoms.net_wm_state_maximized_vert)
def state_skip_taskbar(data, add=StateAdd):
"""Toggles, adds or removes the 'skip_taskbar' state on a window.
StateToggle."""
if not data.client: return
ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(),
- otk.Property_atoms().net_wm_state, data.client.window(),
- add, otk.Property_atoms().net_wm_state_skip_taskbar)
+ otk.atoms.net_wm_state, data.client.window(),
+ add, otk.atoms.net_wm_state_skip_taskbar)
def state_skip_pager(data, add=StateAdd):
"""Toggles, adds or removes the 'skip_pager' state on a window.
StateToggle."""
if not data.client: return
ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(),
- otk.Property_atoms().net_wm_state, data.client.window(),
- add, otk.Property_atoms().net_wm_state_skip_pager)
+ otk.atoms.net_wm_state, data.client.window(),
+ add, otk.atoms.net_wm_state_skip_pager)
def iconify(data):
"""Iconifies the window on which the event occured"""
if not data.client: return
ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(),
- otk.Property_atoms().wm_change_state,
+ otk.atoms.wm_change_state,
data.client.window(), 3) # IconicState
def restore(data):
use the activate() function."""
if not data.client: return
ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(),
- otk.Property_atoms().wm_change_state,
+ otk.atoms.wm_change_state,
data.client.window(), 1) # NormalState
def close(data):
"""Closes the window on which the event occured"""
if not data.client: return
ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(),
- otk.Property_atoms().net_close_window,
+ otk.atoms.net_close_window,
data.client.window(), 0)
def focus(data):
def change_desktop(data, num):
"""Switches to a specified desktop"""
root = otk.display.screenInfo(data.screen).rootWindow()
- ob.send_client_msg(root, otk.Property_atoms().net_current_desktop,
+ ob.send_client_msg(root, otk.atoms.net_current_desktop,
root, num)
+def show_desktop(data, show=1):
+ """Shows and focuses the desktop, hiding any client windows. Optionally,
+ if show is zero, this will hide the desktop, leaving show-desktop
+ mode."""
+ root = otk.display.screenInfo(data.screen).rootWindow()
+ ob.send_client_msg(root, otk.atoms.net_showing_desktop, root, show)
+
+def hide_desktop(data):
+ """Hides the desktop, re-showing the client windows. Leaves show-desktop
+ mode."""
+ show_desktop(data, 0)
+
+def toggle_show_desktop(data):
+ """Requests the Openbox to show the desktop, hiding the client windows, or
+ redisplay the clients."""
+ # get the current desktop state
+ root = otk.display.screenInfo(data.screen).rootWindow()
+ result, value = otk.Property_get(root, otk.atoms.net_showing_desktop,
+ otk.atoms.cardinal)
+ if not result: return
+ show = not value
+ ob.send_client_msg(root, otk.atoms.net_showing_desktop, root, show)
+
def next_desktop(data, no_wrap=0):
"""Switches to the next desktop, optionally (by default) cycling around to
the first when going past the last."""
d = n - 1
change_desktop(data, d)
-def send_to_desktop(data, num):
+def up_desktop(data, num=1):
+ """Switches to the desktop vertically above the current one. This is based
+ on the desktop layout chosen by an EWMH compliant pager. Optionally, num
+ can be specified to move more than one row at a time."""
+ screen = ob.openbox.screen(data.screen)
+ d = screen.desktop()
+ n = screen.numDesktops()
+ l = screen.desktopLayout()
+
+ target = d - num * l.columns
+ if target < 0:
+ target += l.rows * l.columns
+ while target >= n:
+ target -= l.columns
+ change_desktop(data, target)
+
+def down_desktop(data, num=1):
+ """Switches to the desktop vertically below the current one. This is based
+ on the desktop layout chosen by an EWMH compliant pager. Optionally, num
+ can be specified to move more than one row at a time."""
+ screen = ob.openbox.screen(data.screen)
+ d = screen.desktop()
+ n = screen.numDesktops()
+ l = screen.desktopLayout()
+
+ target = d + num * l.columns
+ if target >= n:
+ target -= l.rows * l.columns
+ while target < 0:
+ target += l.columns
+ change_desktop(data, target)
+
+def left_desktop(data, num=1):
+ """Switches to the desktop horizotally left of the current one. This is
+ based on the desktop layout chosen by an EWMH compliant pager.
+ Optionally, num can be specified to move more than one column at a
+ time."""
+ screen = ob.openbox.screen(data.screen)
+ d = screen.desktop()
+ n = screen.numDesktops()
+ l = screen.desktopLayout()
+
+ rowstart = d - d % l.columns
+ target = d - num
+ while target < rowstart:
+ target += l.columns
+ change_desktop(data, target)
+
+def right_desktop(data, num=1):
+ """Switches to the desktop horizotally right of the current one. This is
+ based on the desktop layout chosen by an EWMH compliant pager.
+ Optionally, num can be specified to move more than one column at a
+ time."""
+ screen = ob.openbox.screen(data.screen)
+ d = screen.desktop()
+ n = screen.numDesktops()
+ l = screen.desktopLayout()
+
+ rowstart = d - d % l.columns
+ target = d + num
+ while target >= rowstart + l.columns:
+ target -= l.columns
+ change_desktop(data, target)
+
+def send_to_desktop(data, num=1):
"""Sends a client to a specified desktop"""
if not data.client: return
ob.send_client_msg(otk.display.screenInfo(data.screen).rootWindow(),
- otk.Property_atoms().net_wm_desktop,
+ otk.atoms.net_wm_desktop,
data.client.window(),num)
def toggle_all_desktops(data):
if follow:
change_desktop(data, d)
+def restart(data=0, other = ""):
+ """Restarts Openbox, optionally starting another window manager."""
+ ob.openbox.restart(other)
+
+def exit(data=0):
+ """Exits Openbox."""
+ ob.openbox.shutdown()
+
print "Loaded callbacks.py"