]>
Dogcows Code - chaz/openbox/blob - scripts/builtins.py
1 ###########################################################################
2 ### Functions that can be used as callbacks for mouse/keyboard bindings ###
3 ###########################################################################
5 def state_above(data
, add
=2):
6 """Toggles, adds or removes the 'above' state on a window."""
7 if not data
.client
: return
8 send_client_msg(display
.screenInfo(data
.screen
).rootWindow(),
9 Property_atoms().net_wm_state
, data
.client
.window(), add
,
10 Property_atoms().net_wm_state_above
)
12 def state_below(data
, add
=2):
13 """Toggles, adds or removes the 'below' state on a window."""
14 if not data
.client
: return
15 send_client_msg(display
.screenInfo(data
.screen
).rootWindow(),
16 Property_atoms().net_wm_state
, data
.client
.window(), add
,
17 Property_atoms().net_wm_state_below
)
19 def state_shaded(data
, add
=2):
20 """Toggles, adds or removes the 'shaded' state on a window."""
21 if not data
.client
: return
22 send_client_msg(display
.screenInfo(data
.screen
).rootWindow(),
23 Property_atoms().net_wm_state
, data
.client
.window(), add
,
24 Property_atoms().net_wm_state_shaded
)
27 """Iconifies the window on which the event occured"""
28 if not data
.client
: return
29 send_client_msg(display
.screenInfo(data
.screen
).rootWindow(),
30 Property_atoms().wm_change_state
,
31 data
.client
.window(), 3) # IconicState
34 """Un-iconifies the window on which the event occured, but does not focus
35 if. If you want to focus the window too, it is recommended that you
36 use the activate() function."""
37 if not data
.client
: return
38 send_client_msg(display
.screenInfo(data
.screen
).rootWindow(),
39 Property_atoms().wm_change_state
,
40 data
.client
.window(), 1) # NormalState
43 """Closes the window on which the event occured"""
44 if not data
.client
: return
45 send_client_msg(display
.screenInfo(data
.screen
).rootWindow(),
46 Property_atoms().net_close_window
, data
.client
.window(), 0)
49 """Focuses the window on which the event occured"""
50 if not data
.client
: return
51 # !normal windows dont get focus from window enter events
52 if data
.action
== EventEnterWindow
and not data
.client
.normal():
57 """Moves the window interactively. This should only be used with
59 if not data
.client
: return
61 # !normal windows dont get moved
62 if not data
.client
.normal(): return
64 dx
= data
.xroot
- data
.pressx
65 dy
= data
.yroot
- data
.pressy
66 data
.client
.move(data
.press_clientx
+ dx
, data
.press_clienty
+ dy
)
69 """Resizes the window interactively. This should only be used with
71 if not data
.client
: return
73 # !normal windows dont get moved
74 if not data
.client
.normal(): return
81 # pick a corner to anchor
82 if not (resize_nearest
or data
.context
== MC_Grip
):
83 corner
= Client
.TopLeft
85 x
= px
- data
.press_clientx
86 y
= py
- data
.press_clienty
87 if y
< data
.press_clientheight
/ 2:
88 if x
< data
.press_clientwidth
/ 2:
89 corner
= Client
.BottomRight
92 corner
= Client
.BottomLeft
95 if x
< data
.press_clientwidth
/ 2:
96 corner
= Client
.TopRight
99 corner
= Client
.TopLeft
101 data
.client
.resize(corner
,
102 data
.press_clientwidth
+ dx
,
103 data
.press_clientheight
+ dy
);
105 def restart(data
, other
= ""):
106 """Restarts openbox, optionally starting another window manager."""
107 openbox
.restart(other
)
110 """Raises the window on which the event occured"""
111 if not data
.client
: return
112 openbox
.screen(data
.screen
).raiseWindow(data
.client
)
115 """Lowers the window on which the event occured"""
116 if not data
.client
: return
117 openbox
.screen(data
.screen
).lowerWindow(data
.client
)
119 def toggle_shade(data
):
120 """Toggles the shade status of the window on which the event occured"""
124 """Shades the window on which the event occured"""
125 state_shaded(data
, 1)
128 """Unshades the window on which the event occured"""
129 state_shaded(data
, 0)
131 def change_desktop(data
, num
):
132 """Switches to a specified desktop"""
133 root
= display
.screenInfo(data
.screen
).rootWindow()
134 send_client_msg(root
, Property_atoms().net_current_desktop
, root
, num
)
136 def next_desktop(data
, no_wrap
=0):
137 """Switches to the next desktop, optionally (by default) cycling around to
138 the first when going past the last."""
139 screen
= openbox
.screen(data
.screen
)
141 n
= screen
.numDesktops()
146 change_desktop(data
, d
)
148 def prev_desktop(data
, no_wrap
=0):
149 """Switches to the previous desktop, optionally (by default) cycling around
150 to the last when going past the first."""
151 screen
= openbox
.screen(data
.screen
)
153 n
= screen
.numDesktops()
158 change_desktop(data
, d
)
160 def send_to_desktop(data
, num
):
161 """Sends a client to a specified desktop"""
162 if not data
.client
: return
163 send_client_msg(display
.screenInfo(data
.screen
).rootWindow(),
164 Property_atoms().net_wm_desktop
, data
.client
.window(), num
)
166 def toggle_all_desktops(data
):
167 """Toggles between sending a client to all desktops and to the current
169 if not data
.client
: return
170 if not data
.client
.desktop() == 0xffffffff:
171 send_to_desktop(data
, 0xffffffff)
173 send_to_desktop(data
, openbox
.screen(data
.screen
).desktop())
175 def send_to_all_desktops(data
):
176 """Sends a client to all desktops"""
177 if not data
.client
: return
178 send_to_desktop(data
, 0xffffffff)
180 def send_to_next_desktop(data
, no_wrap
=0, follow
=1):
181 """Sends a window to the next desktop, optionally (by default) cycling
182 around to the first when going past the last. Also optionally moving to
183 the new desktop after sending the window."""
184 if not data
.client
: return
185 screen
= openbox
.screen(data
.screen
)
187 n
= screen
.numDesktops()
192 send_to_desktop(data
, d
)
194 change_desktop(data
, d
)
196 def send_to_prev_desktop(data
, no_wrap
=0, follow
=1):
197 """Sends a window to the previous desktop, optionally (by default) cycling
198 around to the last when going past the first. Also optionally moving to
199 the new desktop after sending the window."""
200 if not data
.client
: return
201 screen
= openbox
.screen(data
.screen
)
203 n
= screen
.numDesktops()
208 send_to_desktop(data
, d
)
210 change_desktop(data
, d
)
212 #########################################
213 ### Convenience functions for scripts ###
214 #########################################
216 def execute(bin
, screen
= 0):
217 """Executes a command on the specified screen. It is recommended that you
218 use this call instead of a python system call. If the specified screen
219 is beyond your range of screens, the default is used instead."""
220 openbox
.execute(screen
, bin
)
222 def setup_click_focus(click_raise
= 1):
223 """Sets up for focusing windows by clicking on or in the window.
224 Optionally, clicking on or in a window can raise the window to the
225 front of its stacking layer."""
226 mbind("Left", MC_Titlebar
, MousePress
, focus
)
227 mbind("Left", MC_Handle
, MousePress
, focus
)
228 mbind("Left", MC_Grip
, MousePress
, focus
)
229 mbind("Left", MC_Window
, MousePress
, focus
)
230 mbind("A-Left", MC_Frame
, MousePress
, focus
)
232 mbind("Left", MC_Titlebar
, MousePress
, raise_win
)
233 mbind("Left", MC_Handle
, MousePress
, raise_win
)
234 mbind("Left", MC_Grip
, MousePress
, raise_win
)
235 mbind("Left", MC_Window
, MousePress
, raise_win
)
237 def setup_sloppy_focus(click_focus
= 1, click_raise
= 0):
238 """Sets up for focusing windows when the mouse pointer enters them.
239 Optionally, clicking on or in a window can focus it if your pointer
240 ends up inside a window without focus. Also, optionally, clicking on or
241 in a window can raise the window to the front of its stacking layer."""
242 ebind(EventEnterWindow
, focus
)
244 mbind("Left", MC_Titlebar
, MousePress
, focus
)
245 mbind("Left", MC_Handle
, MousePress
, focus
)
246 mbind("Left", MC_Grip
, MousePress
, focus
)
247 mbind("Left", MC_Window
, MousePress
, focus
)
249 mbind("Left", MC_Titlebar
, MousePress
, raise_win
)
250 mbind("Left", MC_Handle
, MousePress
, raise_win
)
251 mbind("Left", MC_Grip
, MousePress
, raise_win
)
252 mbind("Left", MC_Window
, MousePress
, raise_win
)
254 def setup_window_clicks():
255 """Sets up the default bindings for various mouse buttons for various
258 * Alt-left drag anywhere on a window will move it
259 * Alt-right drag anywhere on a window will resize it
260 * Left drag on a window's titlebar/handle will move it
261 * Left drag on a window's handle grips will resize it
262 * Alt-left press anywhere on a window's will raise it to the front of
264 * Left press on a window's titlebar/handle will raise it to the front
265 of its stacking layer.
266 * Alt-middle click anywhere on a window's will lower it to the bottom
267 of its stacking layer.
268 * Middle click on a window's titlebar/handle will lower it to the
269 bottom of its stacking layer.
270 * Double-left click on a window's titlebar will toggle shading it
272 mbind("A-Left", MC_Frame
, MouseMotion
, move
)
273 mbind("Left", MC_Titlebar
, MouseMotion
, move
)
274 mbind("Left", MC_Handle
, MouseMotion
, move
)
276 mbind("A-Right", MC_Frame
, MouseMotion
, resize
)
277 mbind("Left", MC_Grip
, MouseMotion
, resize
)
279 mbind("Left", MC_Titlebar
, MousePress
, raise_win
)
280 mbind("Left", MC_Handle
, MousePress
, raise_win
)
281 mbind("A-Left", MC_Frame
, MousePress
, raise_win
)
282 mbind("A-Middle", MC_Frame
, MouseClick
, lower_win
)
283 mbind("Middle", MC_Titlebar
, MouseClick
, lower_win
)
284 mbind("Middle", MC_Handle
, MouseClick
, lower_win
)
286 mbind("Left", MC_Titlebar
, MouseDoubleClick
, toggle_shade
)
288 def setup_window_buttons():
289 """Sets up the default behaviors for the buttons in the window titlebar."""
290 mbind("Left", MC_AllDesktopsButton
, MouseClick
, toggle_all_desktops
)
291 mbind("Left", MC_CloseButton
, MouseClick
, close
)
292 mbind("Left", MC_IconifyButton
, MouseClick
, iconify
)
295 """Sets up the default behaviors for the mouse scroll wheel.
297 * scrolling on a window titlebar will shade/unshade it
298 * alt-scrolling anywhere will switch to the next/previous desktop
299 * control-alt-scrolling on a window will send it to the next/previous
300 desktop, and switch to the desktop with the window
302 mbind("Up", MC_Titlebar
, MouseClick
, shade
)
303 mbind("Down", MC_Titlebar
, MouseClick
, unshade
)
305 mbind("A-Up", MC_Frame
, MouseClick
, next_desktop
)
306 mbind("A-Up", MC_Root
, MouseClick
, next_desktop
)
307 mbind("A-Down", MC_Frame
, MouseClick
, prev_desktop
)
308 mbind("A-Down", MC_Root
, MouseClick
, prev_desktop
)
310 mbind("C-A-Up", MC_Frame
, MouseClick
, send_to_next_desktop
)
311 mbind("C-A-Down", MC_Frame
, MouseClick
, send_to_prev_desktop
)
313 def setup_fallback_focus():
314 """Sets up a focus fallback routine so that when no windows are focused,
315 the last window to have focus on the desktop will be focused."""
316 global ob_focus_fallback
# see focus.py
317 ob_focus_fallback
= 1
319 ############################################################################
320 ### Window placement algorithms, choose one of these and ebind it to the ###
321 ### EventPlaceWindow action. ###
322 ############################################################################
326 def placewindows_random(data
):
327 if not data
.client
: return
328 client_area
= data
.client
.area()
329 frame_size
= data
.client
.frame
.size()
330 screen
= display
.screenInfo(data
.screen
)
331 width
= screen
.width() - (client_area
.width() +
332 frame_size
.left
+ frame_size
.right
)
333 height
= screen
.height() - (client_area
.height() +
334 frame_size
.top
+ frame_size
.bottom
)
336 if not ob_rand
: ob_rand
= random
.Random()
337 x
= ob_rand
.randrange(0, width
-1)
338 y
= ob_rand
.randrange(0, height
-1)
339 data
.client
.move(x
, y
)
342 print "Loaded builtins.py"
This page took 0.052778 seconds and 5 git commands to generate.