1 ############################################################################
2 ### Functions that can be used as callbacks for mouse/keyboard bindings ###
3 ############################################################################
12 def state_above(data
, add
=StateAdd
):
13 """Toggles, adds or removes the 'above' state on a window.
14 The second paramater should one of: StateRemove, StateAdd, or
16 if not data
.client
: return
17 ob
.send_client_msg(otk
.display
.screenInfo(data
.screen
).rootWindow(),
18 otk
.Property_atoms().net_wm_state
, data
.client
.window(),
19 add
, otk
.Property_atoms().net_wm_state_above
)
21 def state_below(data
, add
=StateAdd
):
22 """Toggles, adds or removes the 'below' state on a window.
23 The second paramater should one of: StateRemove, StateAdd, or
25 if not data
.client
: return
26 ob
.send_client_msg(otk
.display
.screenInfo(data
.screen
).rootWindow(),
27 otk
.Property_atoms().net_wm_state
, data
.client
.window(),
28 add
, otk
.Property_atoms().net_wm_state_below
)
30 def state_shaded(data
, add
=StateAdd
):
31 """Toggles, adds or removes the 'shaded' state on a window.
32 The second paramater should one of: StateRemove, StateAdd, or
34 if not data
.client
: return
35 ob
.send_client_msg(otk
.display
.screenInfo(data
.screen
).rootWindow(),
36 otk
.Property_atoms().net_wm_state
, data
.client
.window(),
37 add
, otk
.Property_atoms().net_wm_state_shaded
)
39 def state_maximize(data
, add
=StateAdd
):
40 """Toggles, adds or removes the horizontal and vertical 'maximized' state
41 on a window. The second paramater should one of: StateRemove, StateAdd,
43 if not data
.client
: return
44 ob
.send_client_msg(otk
.display
.screenInfo(data
.screen
).rootWindow(),
45 otk
.Property_atoms().net_wm_state
, data
.client
.window(),
46 add
, otk
.Property_atoms().net_wm_state_maximized_horz
,
47 otk
.Property_atoms().net_wm_state_maximized_vert
)
49 def state_maximize_horz(data
, add
=StateAdd
):
50 """Toggles, adds or removes the horizontal 'maximized' state on a window.
51 The second paramater should one of: StateRemove, StateAdd, or
53 if not data
.client
: return
54 ob
.send_client_msg(otk
.display
.screenInfo(data
.screen
).rootWindow(),
55 otk
.Property_atoms().net_wm_state
, data
.client
.window(),
56 add
, otk
.Property_atoms().net_wm_state_maximized_horz
)
58 def state_maximize_vert(data
, add
=StateAdd
):
59 """Toggles, adds or removes the vertical 'maximized' state on a window.
60 The second paramater should one of: StateRemove, StateAdd, or
62 if not data
.client
: return
63 ob
.send_client_msg(otk
.display
.screenInfo(data
.screen
).rootWindow(),
64 otk
.Property_atoms().net_wm_state
, data
.client
.window(),
65 add
, otk
.Property_atoms().net_wm_state_maximized_vert
)
67 def state_skip_taskbar(data
, add
=StateAdd
):
68 """Toggles, adds or removes the 'skip_taskbar' state on a window.
69 The second paramater should one of: StateRemove, StateAdd, or
71 if not data
.client
: return
72 ob
.send_client_msg(otk
.display
.screenInfo(data
.screen
).rootWindow(),
73 otk
.Property_atoms().net_wm_state
, data
.client
.window(),
74 add
, otk
.Property_atoms().net_wm_state_skip_taskbar
)
76 def state_skip_pager(data
, add
=StateAdd
):
77 """Toggles, adds or removes the 'skip_pager' state on a window.
78 The second paramater should one of: StateRemove, StateAdd, or
80 if not data
.client
: return
81 ob
.send_client_msg(otk
.display
.screenInfo(data
.screen
).rootWindow(),
82 otk
.Property_atoms().net_wm_state
, data
.client
.window(),
83 add
, otk
.Property_atoms().net_wm_state_skip_pager
)
86 """Iconifies the window on which the event occured"""
87 if not data
.client
: return
88 ob
.send_client_msg(otk
.display
.screenInfo(data
.screen
).rootWindow(),
89 otk
.Property_atoms().wm_change_state
,
90 data
.client
.window(), 3) # IconicState
93 """Un-iconifies the window on which the event occured, but does not focus
94 if. If you want to focus the window too, it is recommended that you
95 use the activate() function."""
96 if not data
.client
: return
97 ob
.send_client_msg(otk
.display
.screenInfo(data
.screen
).rootWindow(),
98 otk
.Property_atoms().wm_change_state
,
99 data
.client
.window(), 1) # NormalState
102 """Closes the window on which the event occured"""
103 if not data
.client
: return
104 ob
.send_client_msg(otk
.display
.screenInfo(data
.screen
).rootWindow(),
105 otk
.Property_atoms().net_close_window
,
106 data
.client
.window(), 0)
109 """Focuses the window on which the event occured"""
110 if not data
.client
: return
111 # !normal windows dont get focus from window enter events
112 if data
.action
== ob
.EventAction
.EnterWindow
and not data
.client
.normal():
116 def restart(data
, other
= ""):
117 """Restarts Openbox, optionally starting another window manager."""
118 ob
.openbox
.restart(other
)
122 ob
.openbox
.shutdown()
125 """Raises the window on which the event occured"""
126 if not data
.client
: return
127 ob
.openbox
.screen(data
.screen
).raiseWindow(data
.client
)
130 """Lowers the window on which the event occured"""
131 if not data
.client
: return
132 ob
.openbox
.screen(data
.screen
).lowerWindow(data
.client
)
134 def toggle_maximize(data
):
135 """Toggles the maximized status of the window on which the event occured"""
136 state_maximize(data
, StateToggle
)
138 def toggle_maximize_horz(data
):
139 """Toggles the horizontal maximized status of the window on which the event
141 state_maximize_horz(data
, StateToggle
)
143 def toggle_maximize_vert(data
):
144 """Toggles the vertical maximized status of the window on which the event
146 state_maximize_vert(data
, StateToggle
)
149 """Maximizes the window on which the event occured"""
150 state_maximize(data
, StateAdd
)
152 def maximize_horz(data
):
153 """Horizontally maximizes the window on which the event occured"""
154 state_maximize_horz(data
, StateAdd
)
156 def maximize_vert(data
):
157 """Vertically maximizes the window on which the event occured"""
158 state_maximize_vert(data
, StateAdd
)
160 def unmaximize(data
):
161 """Unmaximizes the window on which the event occured"""
162 state_maximize(data
, StateRemove
)
164 def unmaximize_horz(data
):
165 """Horizontally unmaximizes the window on which the event occured"""
166 state_maximize_horz(data
, StateRemove
)
168 def unmaximize_vert(data
):
169 """Vertically unmaximizes the window on which the event occured"""
170 state_maximize_vert(data
, StateRemove
)
172 def toggle_shade(data
):
173 """Toggles the shade status of the window on which the event occured"""
174 state_shaded(data
, StateToggle
)
177 """Shades the window on which the event occured"""
178 state_shaded(data
, StateAdd
)
181 """Unshades the window on which the event occured"""
182 state_shaded(data
, StateRemove
)
184 def change_desktop(data
, num
):
185 """Switches to a specified desktop"""
186 root
= otk
.display
.screenInfo(data
.screen
).rootWindow()
187 ob
.send_client_msg(root
, otk
.Property_atoms().net_current_desktop
,
190 def next_desktop(data
, no_wrap
=0):
191 """Switches to the next desktop, optionally (by default) cycling around to
192 the first when going past the last."""
193 screen
= ob
.openbox
.screen(data
.screen
)
195 n
= screen
.numDesktops()
200 change_desktop(data
, d
)
202 def prev_desktop(data
, no_wrap
=0):
203 """Switches to the previous desktop, optionally (by default) cycling around
204 to the last when going past the first."""
205 screen
= ob
.openbox
.screen(data
.screen
)
207 n
= screen
.numDesktops()
212 change_desktop(data
, d
)
214 def send_to_desktop(data
, num
):
215 """Sends a client to a specified desktop"""
216 if not data
.client
: return
217 ob
.send_client_msg(otk
.display
.screenInfo(data
.screen
).rootWindow(),
218 otk
.Property_atoms().net_wm_desktop
,
219 data
.client
.window(),num
)
221 def toggle_all_desktops(data
):
222 """Toggles between sending a client to all desktops and to the current
224 if not data
.client
: return
225 if not data
.client
.desktop() == 0xffffffff:
226 send_to_desktop(data
, 0xffffffff)
228 send_to_desktop(data
, ob
.openbox
.screen(data
.screen
).desktop())
230 def send_to_all_desktops(data
):
231 """Sends a client to all desktops"""
232 if not data
.client
: return
233 send_to_desktop(data
, 0xffffffff)
235 def send_to_next_desktop(data
, no_wrap
=0, follow
=1):
236 """Sends a window to the next desktop, optionally (by default) cycling
237 around to the first when going past the last. Also optionally moving to
238 the new desktop after sending the window."""
239 if not data
.client
: return
240 screen
= ob
.openbox
.screen(data
.screen
)
242 n
= screen
.numDesktops()
247 send_to_desktop(data
, d
)
249 change_desktop(data
, d
)
251 def send_to_prev_desktop(data
, no_wrap
=0, follow
=1):
252 """Sends a window to the previous desktop, optionally (by default) cycling
253 around to the last when going past the first. Also optionally moving to
254 the new desktop after sending the window."""
255 if not data
.client
: return
256 screen
= ob
.openbox
.screen(data
.screen
)
258 n
= screen
.numDesktops()
263 send_to_desktop(data
, d
)
265 change_desktop(data
, d
)
267 print "Loaded callbacks.py"