<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html> <head> <!-- Generated by HsColour, http://code.haskell.org/~malcolm/hscolour/ --> <title>XMonad/Actions/CycleWindows.hs</title> <link type='text/css' rel='stylesheet' href='hscolour.css' /> </head> <body> <pre><a name="line-1"></a><span class='hs-comment'>--------------------------------------------------------------------------------</span> <a name="line-2"></a><span class='hs-comment'>-- |</span> <a name="line-3"></a><span class='hs-comment'>-- Module : XMonad.Actions.CycleWindows</span> <a name="line-4"></a><span class='hs-comment'>-- Copyright : (c) Wirt Wolff <wirtwolff@gmail.com></span> <a name="line-5"></a><span class='hs-comment'>-- License : BSD3-style (see LICENSE)</span> <a name="line-6"></a><span class='hs-comment'>--</span> <a name="line-7"></a><span class='hs-comment'>-- Maintainer : Wirt Wolff <wirtwolff@gmail.com></span> <a name="line-8"></a><span class='hs-comment'>-- Stability : unstable</span> <a name="line-9"></a><span class='hs-comment'>-- Portability : unportable</span> <a name="line-10"></a><span class='hs-comment'>--</span> <a name="line-11"></a><span class='hs-comment'>-- Provides bindings to cycle windows up or down on the current workspace</span> <a name="line-12"></a><span class='hs-comment'>-- stack while maintaining focus in place.</span> <a name="line-13"></a><span class='hs-comment'>--</span> <a name="line-14"></a><span class='hs-comment'>-- Bindings are available to:</span> <a name="line-15"></a><span class='hs-comment'>--</span> <a name="line-16"></a><span class='hs-comment'>-- * Cycle nearby or nth windows into the focused frame</span> <a name="line-17"></a><span class='hs-comment'>--</span> <a name="line-18"></a><span class='hs-comment'>-- * Cycle a window halfway around the stack</span> <a name="line-19"></a><span class='hs-comment'>--</span> <a name="line-20"></a><span class='hs-comment'>-- * Cycle windows through the focused position.</span> <a name="line-21"></a><span class='hs-comment'>--</span> <a name="line-22"></a><span class='hs-comment'>-- * Cycle unfocused windows.</span> <a name="line-23"></a><span class='hs-comment'>--</span> <a name="line-24"></a><span class='hs-comment'>-- These bindings are especially useful with layouts that hide some of</span> <a name="line-25"></a><span class='hs-comment'>-- the windows in the stack, such as Full, "XMonad.Layout.TwoPane" or</span> <a name="line-26"></a><span class='hs-comment'>-- when using "XMonad.Layout.LimitWindows" to only show three or four</span> <a name="line-27"></a><span class='hs-comment'>-- panes. See also "XMonad.Actions.RotSlaves" for related actions.</span> <a name="line-28"></a><span class='hs-comment'>-----------------------------------------------------------------------------</span> <a name="line-29"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>Actions</span><span class='hs-varop'>.</span><span class='hs-conid'>CycleWindows</span> <span class='hs-layout'>(</span> <a name="line-30"></a> <span class='hs-comment'>-- * Usage</span> <a name="line-31"></a> <span class='hs-comment'>-- $usage</span> <a name="line-32"></a> <a name="line-33"></a> <span class='hs-comment'>-- * Cycling nearby or nth window into current frame</span> <a name="line-34"></a> <span class='hs-comment'>-- $cycle</span> <a name="line-35"></a> <span class='hs-varid'>cycleRecentWindows</span><span class='hs-layout'>,</span> <a name="line-36"></a> <span class='hs-varid'>cycleStacks'</span><span class='hs-layout'>,</span> <a name="line-37"></a> <span class='hs-comment'>-- * Cycling half the stack to get rid of a boring window</span> <a name="line-38"></a> <span class='hs-comment'>-- $opposite</span> <a name="line-39"></a> <span class='hs-varid'>rotOpposite'</span><span class='hs-layout'>,</span> <span class='hs-varid'>rotOpposite</span><span class='hs-layout'>,</span> <a name="line-40"></a> <span class='hs-comment'>-- * Cycling windows through the current frame</span> <a name="line-41"></a> <span class='hs-comment'>-- $focused</span> <a name="line-42"></a> <span class='hs-varid'>rotFocused'</span><span class='hs-layout'>,</span> <span class='hs-varid'>rotFocusedUp</span><span class='hs-layout'>,</span> <span class='hs-varid'>rotFocusedDown</span><span class='hs-layout'>,</span> <span class='hs-varid'>shiftToFocus'</span><span class='hs-layout'>,</span> <a name="line-43"></a> <span class='hs-comment'>-- * Cycling windows through other frames</span> <a name="line-44"></a> <span class='hs-comment'>-- $unfocused</span> <a name="line-45"></a> <span class='hs-varid'>rotUnfocused'</span><span class='hs-layout'>,</span> <span class='hs-varid'>rotUnfocusedUp</span><span class='hs-layout'>,</span> <span class='hs-varid'>rotUnfocusedDown</span><span class='hs-layout'>,</span> <a name="line-46"></a> <span class='hs-comment'>-- * Updating the mouse pointer</span> <a name="line-47"></a> <span class='hs-comment'>-- $pointer</span> <a name="line-48"></a> <a name="line-49"></a> <span class='hs-comment'>-- * Generic list rotations</span> <a name="line-50"></a> <span class='hs-comment'>-- $generic</span> <a name="line-51"></a> <span class='hs-varid'>rotUp</span><span class='hs-layout'>,</span> <span class='hs-varid'>rotDown</span> <a name="line-52"></a><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span> <a name="line-53"></a> <a name="line-54"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span> <a name="line-55"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>StackSet</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>W</span> <a name="line-56"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>Actions</span><span class='hs-varop'>.</span><span class='hs-conid'>RotSlaves</span> <a name="line-57"></a> <a name="line-58"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Arrow</span> <span class='hs-layout'>(</span><span class='hs-varid'>second</span><span class='hs-layout'>)</span> <a name="line-59"></a> <a name="line-60"></a><span class='hs-comment'>-- $usage</span> <a name="line-61"></a><span class='hs-comment'>-- You can use this module with the following in your @~\/.xmonad\/xmonad.hs@ file:</span> <a name="line-62"></a><span class='hs-comment'>--</span> <a name="line-63"></a><span class='hs-comment'>-- > import XMonad.Actions.CycleWindows</span> <a name="line-64"></a><span class='hs-comment'>-- > -- config</span> <a name="line-65"></a><span class='hs-comment'>-- > -- other key bindings with x here your config</span> <a name="line-66"></a><span class='hs-comment'>-- ></span> <a name="line-67"></a><span class='hs-comment'>-- > -- make sure mod matches keysym</span> <a name="line-68"></a><span class='hs-comment'>-- > , ((mod4Mask, xK_s), cycleRecentWindows [xK_Super_L] xK_s xK_w)</span> <a name="line-69"></a><span class='hs-comment'>-- > , ((modm, xK_z), rotOpposite)</span> <a name="line-70"></a><span class='hs-comment'>-- > , ((modm , xK_i), rotUnfocusedUp)</span> <a name="line-71"></a><span class='hs-comment'>-- > , ((modm , xK_u), rotUnfocusedDown)</span> <a name="line-72"></a><span class='hs-comment'>-- > , ((modm .|. controlMask, xK_i), rotFocusedUp)</span> <a name="line-73"></a><span class='hs-comment'>-- > , ((modm .|. controlMask, xK_u), rotFocusedDown)</span> <a name="line-74"></a><span class='hs-comment'>--</span> <a name="line-75"></a><span class='hs-comment'>-- Also, if you use focus follows mouse, you will want to read the section</span> <a name="line-76"></a><span class='hs-comment'>-- on updating the mouse pointer below. For detailed instructions on</span> <a name="line-77"></a><span class='hs-comment'>-- editing your key bindings, see "XMonad.Doc.Extending#Editing_key_bindings".</span> <a name="line-78"></a><span class='hs-comment'>{- $pointer <a name="line-79"></a>With FocusFollowsMouse == True, the focus is updated after binding <a name="line-80"></a>actions, possibly focusing a window you didn't intend to focus. Most <a name="line-81"></a>people using TwoPane probably already have a logHook causing the mouse <a name="line-82"></a>to follow focus. (See "XMonad.Actions.UpdatePointer", or "XMonad.Actions.Warp") <a name="line-83"></a> <a name="line-84"></a>If you want this built into the key binding instead, use the appropriate <a name="line-85"></a>action from one of those modules to also have your bindings move the pointer <a name="line-86"></a>to the point of your choice on the current window: <a name="line-87"></a> <a name="line-88"></a>> import XMonad.Actions.UpdatePointer -- or Actions.Warp <a name="line-89"></a> <a name="line-90"></a>and either <a name="line-91"></a> <a name="line-92"></a>> -- modify the window rotation bindings <a name="line-93"></a>> , ((modm .|. controlMask, xK_i ), rotFocusedUp <a name="line-94"></a>> >> updatePointer (Relative 1 1)) <a name="line-95"></a>> , ((modm .|. controlMask, xK_u ), rotFocusedDown <a name="line-96"></a>> >> updatePointer (Relative 1 1)) <a name="line-97"></a>> <a name="line-98"></a>> -- or add to xmonad's logHook <a name="line-99"></a>> , logHook = dynamicLogWithPP xmobarPP <a name="line-100"></a>> >> updatePointer Nearest -- or your preference <a name="line-101"></a> <a name="line-102"></a>-}</span> <a name="line-103"></a> <a name="line-104"></a><a name="cycleRecentWindows"></a><span class='hs-comment'>-- $cycle</span> <a name="line-105"></a><span class='hs-comment'>-- Cycle windows into focus from below or above the focused pane by pressing</span> <a name="line-106"></a><span class='hs-comment'>-- a key while one or more modifier keys is held down. The window order isn't</span> <a name="line-107"></a><span class='hs-comment'>-- changed until a modifier is released, leaving the previously focused window</span> <a name="line-108"></a><span class='hs-comment'>-- just below the new one, (or above if the window just above is chosen.) For</span> <a name="line-109"></a><span class='hs-comment'>-- best results use the same modifier + key combination as the one used to invoke</span> <a name="line-110"></a><span class='hs-comment'>-- the \"bring from below\" action. Also, once cycling, pressing a number key n</span> <a name="line-111"></a><span class='hs-comment'>-- will focus the nth window, with 0 being the one originally focused.</span> <a name="line-112"></a><span class='hs-definition'>cycleRecentWindows</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>KeySym</span><span class='hs-keyglyph'>]</span> <span class='hs-comment'>-- ^ A list of modifier keys used when invoking this action.</span> <a name="line-113"></a> <span class='hs-comment'>-- As soon as one of them is released, the final switch is made.</span> <a name="line-114"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>KeySym</span> <span class='hs-comment'>-- ^ Key used to shift windows from below the current choice into the current frame.</span> <a name="line-115"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>KeySym</span> <span class='hs-comment'>-- ^ Key used to shift windows from above the current choice into the current frame.</span> <a name="line-116"></a> <span class='hs-comment'>-- If it's the same as the first key, it is effectively ignored.</span> <a name="line-117"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-118"></a><span class='hs-definition'>cycleRecentWindows</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>cycleStacks'</span> <span class='hs-varid'>stacks</span> <span class='hs-keyword'>where</span> <a name="line-119"></a> <span class='hs-varid'>stacks</span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>map</span> <span class='hs-layout'>(</span><span class='hs-varid'>shiftToFocus'</span> <span class='hs-varop'>`flip`</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>wins</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <a name="line-120"></a> <span class='hs-varid'>wins</span> <span class='hs-layout'>(</span><span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-varid'>t</span> <span class='hs-varid'>l</span> <span class='hs-varid'>r</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>t</span> <span class='hs-conop'>:</span> <span class='hs-varid'>r</span> <span class='hs-varop'>++</span> <span class='hs-varid'>reverse</span> <span class='hs-varid'>l</span> <a name="line-121"></a> <a name="line-122"></a> <a name="line-123"></a><a name="cycleStacks'"></a><span class='hs-comment'>-- | Cycle through a /finite/ list of window stacks with repeated presses</span> <a name="line-124"></a><span class='hs-comment'>-- of a key while a modifier key is held down. For best results use the same</span> <a name="line-125"></a><span class='hs-comment'>-- mod key + key combination as the one used to invoke the \"bring from below\"</span> <a name="line-126"></a><span class='hs-comment'>-- action. You could use cycleStacks' with a different stack permutations</span> <a name="line-127"></a><span class='hs-comment'>-- function to, for example, cycle from one below to one above to two below,</span> <a name="line-128"></a><span class='hs-comment'>-- etc. instead of in order. You are responsible for having it generate a</span> <a name="line-129"></a><span class='hs-comment'>-- finite list, though, or xmonad may hang seeking its length.</span> <a name="line-130"></a><span class='hs-definition'>cycleStacks'</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-conid'>Window</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-conid'>Window</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- ^ A function to a finite list of permutations of a given stack.</span> <a name="line-131"></a> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>KeySym</span><span class='hs-keyglyph'>]</span> <span class='hs-comment'>-- ^ A list of modifier keys used to invoke 'cycleStacks''.</span> <a name="line-132"></a> <span class='hs-comment'>-- As soon as any is released, we're no longer cycling on the [Stack Window]</span> <a name="line-133"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>KeySym</span> <span class='hs-comment'>-- ^ Key used to select a \"next\" stack.</span> <a name="line-134"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>KeySym</span> <span class='hs-comment'>-- ^ Key used to select a \"previous\" stack.</span> <a name="line-135"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-136"></a><span class='hs-definition'>cycleStacks'</span> <span class='hs-varid'>filteredPerms</span> <span class='hs-varid'>mods</span> <span class='hs-varid'>keyNext</span> <span class='hs-varid'>keyPrev</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <a name="line-137"></a> <span class='hs-conid'>XConf</span> <span class='hs-layout'>{</span><span class='hs-varid'>theRoot</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>root</span><span class='hs-layout'>,</span> <span class='hs-varid'>display</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>d</span><span class='hs-layout'>}</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>ask</span> <a name="line-138"></a> <span class='hs-varid'>stacks</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>gets</span> <span class='hs-varop'>$</span> <span class='hs-varid'>maybe</span> <span class='hs-conid'>[]</span> <span class='hs-varid'>filteredPerms</span> <span class='hs-varop'>.</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>stack</span> <span class='hs-varop'>.</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>workspace</span> <span class='hs-varop'>.</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>current</span> <span class='hs-varop'>.</span> <span class='hs-varid'>windowset</span> <a name="line-139"></a> <a name="line-140"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>evt</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>allocaXEvent</span> <span class='hs-varop'>$</span> <a name="line-141"></a> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span> <span class='hs-varid'>maskEvent</span> <span class='hs-varid'>d</span> <span class='hs-layout'>(</span><span class='hs-varid'>keyPressMask</span> <span class='hs-varop'>.|.</span> <span class='hs-varid'>keyReleaseMask</span><span class='hs-layout'>)</span> <span class='hs-varid'>p</span> <a name="line-142"></a> <span class='hs-conid'>KeyEvent</span> <span class='hs-layout'>{</span><span class='hs-varid'>ev_event_type</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>t</span><span class='hs-layout'>,</span> <span class='hs-varid'>ev_keycode</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>c</span><span class='hs-layout'>}</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>getEvent</span> <span class='hs-varid'>p</span> <a name="line-143"></a> <span class='hs-varid'>s</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>keycodeToKeysym</span> <span class='hs-varid'>d</span> <span class='hs-varid'>c</span> <span class='hs-num'>0</span> <a name="line-144"></a> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-varid'>t</span><span class='hs-layout'>,</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <a name="line-145"></a> <span class='hs-varid'>choose</span> <span class='hs-varid'>n</span> <span class='hs-layout'>(</span><span class='hs-varid'>t</span><span class='hs-layout'>,</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <a name="line-146"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>t</span> <span class='hs-varop'>==</span> <span class='hs-varid'>keyPress</span> <span class='hs-varop'>&&</span> <span class='hs-varid'>s</span> <span class='hs-varop'>==</span> <span class='hs-varid'>keyNext</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>io</span> <span class='hs-varid'>evt</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>choose</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-varop'>+</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <a name="line-147"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>t</span> <span class='hs-varop'>==</span> <span class='hs-varid'>keyPress</span> <span class='hs-varop'>&&</span> <span class='hs-varid'>s</span> <span class='hs-varop'>==</span> <span class='hs-varid'>keyPrev</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>io</span> <span class='hs-varid'>evt</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>choose</span> <span class='hs-layout'>(</span><span class='hs-varid'>n</span><span class='hs-comment'>-</span><span class='hs-num'>1</span><span class='hs-layout'>)</span> <a name="line-148"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>t</span> <span class='hs-varop'>==</span> <span class='hs-varid'>keyPress</span> <span class='hs-varop'>&&</span> <span class='hs-varid'>s</span> <span class='hs-varop'>`elem`</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>xK_0</span><span class='hs-keyglyph'>..</span><span class='hs-varid'>xK_9</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>io</span> <span class='hs-varid'>evt</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>choose</span> <span class='hs-layout'>(</span><span class='hs-varid'>numKeyToN</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <a name="line-149"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>t</span> <span class='hs-varop'>==</span> <span class='hs-varid'>keyRelease</span> <span class='hs-varop'>&&</span> <span class='hs-varid'>s</span> <span class='hs-varop'>`elem`</span> <span class='hs-varid'>mods</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-conid'>()</span> <a name="line-150"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>doStack</span> <span class='hs-varid'>n</span> <span class='hs-varop'>>></span> <span class='hs-varid'>io</span> <span class='hs-varid'>evt</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>choose</span> <span class='hs-varid'>n</span> <a name="line-151"></a> <span class='hs-varid'>doStack</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>windows</span> <span class='hs-varop'>.</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>modify'</span> <span class='hs-varop'>.</span> <span class='hs-varid'>const</span> <span class='hs-varop'>$</span> <span class='hs-varid'>stacks</span> <span class='hs-varop'>`cycref`</span> <span class='hs-varid'>n</span> <a name="line-152"></a> <a name="line-153"></a> <span class='hs-varid'>io</span> <span class='hs-varop'>$</span> <span class='hs-varid'>grabKeyboard</span> <span class='hs-varid'>d</span> <span class='hs-varid'>root</span> <span class='hs-conid'>False</span> <span class='hs-varid'>grabModeAsync</span> <span class='hs-varid'>grabModeAsync</span> <span class='hs-varid'>currentTime</span> <a name="line-154"></a> <span class='hs-varid'>io</span> <span class='hs-varid'>evt</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>choose</span> <span class='hs-num'>1</span> <a name="line-155"></a> <span class='hs-varid'>io</span> <span class='hs-varop'>$</span> <span class='hs-varid'>ungrabKeyboard</span> <span class='hs-varid'>d</span> <span class='hs-varid'>currentTime</span> <a name="line-156"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>cycref</span> <span class='hs-varid'>l</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>l</span> <span class='hs-varop'>!!</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span> <span class='hs-varop'>`mod`</span> <span class='hs-varid'>length</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- modify' ensures l is never [], but must also be finite</span> <a name="line-157"></a> <span class='hs-varid'>numKeyToN</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>subtract</span> <span class='hs-num'>48</span> <span class='hs-varop'>.</span> <span class='hs-varid'>read</span> <span class='hs-varop'>.</span> <span class='hs-varid'>show</span> <a name="line-158"></a> <a name="line-159"></a><a name="shiftToFocus'"></a><span class='hs-comment'>-- | Given a stack element and a stack, shift or insert the element (window)</span> <a name="line-160"></a><span class='hs-comment'>-- at the currently focused position.</span> <a name="line-161"></a><span class='hs-definition'>shiftToFocus'</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Eq</span> <span class='hs-varid'>a</span><span class='hs-layout'>,</span> <span class='hs-conid'>Show</span> <span class='hs-varid'>a</span><span class='hs-layout'>,</span> <span class='hs-conid'>Read</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-varid'>a</span> <a name="line-162"></a><span class='hs-definition'>shiftToFocus'</span> <span class='hs-varid'>w</span> <span class='hs-varid'>s</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>ls</span> <span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-varid'>w</span> <span class='hs-layout'>(</span><span class='hs-varid'>reverse</span> <span class='hs-varid'>revls'</span><span class='hs-layout'>)</span> <span class='hs-varid'>rs'</span> <a name="line-163"></a> <span class='hs-keyword'>where</span> <span class='hs-layout'>(</span><span class='hs-varid'>revls'</span><span class='hs-layout'>,</span> <span class='hs-varid'>rs'</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>splitAt</span> <span class='hs-layout'>(</span><span class='hs-varid'>length</span> <span class='hs-varid'>ls</span><span class='hs-layout'>)</span> <span class='hs-varop'>.</span> <span class='hs-varid'>filter</span> <span class='hs-layout'>(</span><span class='hs-varop'>/=</span> <span class='hs-varid'>w</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>integrate</span> <span class='hs-varid'>s</span> <a name="line-164"></a> <a name="line-165"></a> <a name="line-166"></a><a name="rotOpposite"></a><span class='hs-comment'>-- $opposite</span> <a name="line-167"></a><span class='hs-comment'>-- Shifts the focused window as far as possible from the current focus,</span> <a name="line-168"></a><span class='hs-comment'>-- i.e. halfway around the stack. Windows above the focus up to the \"opposite\"</span> <a name="line-169"></a><span class='hs-comment'>-- position remain in place, while those above the insertion shift toward</span> <a name="line-170"></a><span class='hs-comment'>-- the current focus. This is useful for people who use lots of windows in Full,</span> <a name="line-171"></a><span class='hs-comment'>-- TwoPane, etc., to get rid of boring windows while cycling and swapping</span> <a name="line-172"></a><span class='hs-comment'>-- near the focus.</span> <a name="line-173"></a><span class='hs-definition'>rotOpposite</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span><span class='hs-conid'>()</span> <a name="line-174"></a><span class='hs-definition'>rotOpposite</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>windows</span> <span class='hs-varop'>$</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>modify'</span> <span class='hs-varid'>rotOpposite'</span> <a name="line-175"></a> <a name="line-176"></a><a name="rotOpposite'"></a><span class='hs-comment'>-- | The opposite rotation on a Stack.</span> <a name="line-177"></a><span class='hs-definition'>rotOpposite'</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-varid'>a</span> <a name="line-178"></a><span class='hs-definition'>rotOpposite'</span> <span class='hs-layout'>(</span><span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-varid'>t</span> <span class='hs-varid'>l</span> <span class='hs-varid'>r</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-varid'>t'</span> <span class='hs-varid'>l'</span> <span class='hs-varid'>r'</span> <a name="line-179"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>rrvl</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>r</span> <span class='hs-varop'>++</span> <span class='hs-varid'>reverse</span> <span class='hs-varid'>l</span> <a name="line-180"></a> <span class='hs-varid'>part</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>length</span> <span class='hs-varid'>rrvl</span> <span class='hs-varop'>+</span> <span class='hs-num'>1</span><span class='hs-layout'>)</span> <span class='hs-varop'>`div`</span> <span class='hs-num'>2</span> <a name="line-181"></a> <span class='hs-layout'>(</span><span class='hs-varid'>l'</span><span class='hs-layout'>,</span><span class='hs-varid'>t'</span><span class='hs-conop'>:</span><span class='hs-varid'>r'</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>second</span> <span class='hs-varid'>reverse</span> <span class='hs-varop'>.</span> <span class='hs-varid'>splitAt</span> <span class='hs-layout'>(</span><span class='hs-varid'>length</span> <span class='hs-varid'>l</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <a name="line-182"></a> <span class='hs-varid'>reverse</span> <span class='hs-layout'>(</span><span class='hs-varid'>take</span> <span class='hs-varid'>part</span> <span class='hs-varid'>rrvl</span> <span class='hs-varop'>++</span> <span class='hs-varid'>t</span> <span class='hs-conop'>:</span> <span class='hs-varid'>drop</span> <span class='hs-varid'>part</span> <span class='hs-varid'>rrvl</span><span class='hs-layout'>)</span> <a name="line-183"></a> <a name="line-184"></a> <a name="line-185"></a><span class='hs-comment'>-- $focused</span> <a name="line-186"></a><span class='hs-comment'>-- Most people will want the @rotAllUp@ or @rotAllDown@ actions from</span> <a name="line-187"></a><span class='hs-comment'>-- "XMonad.Actions.RotSlaves" to cycle all windows in the stack.</span> <a name="line-188"></a><span class='hs-comment'>--</span> <a name="line-189"></a><span class='hs-comment'>-- The following actions keep the \"next\" window stable, which is</span> <a name="line-190"></a><span class='hs-comment'>-- mostly useful in two window layouts, or when you have a log viewer or</span> <a name="line-191"></a><span class='hs-comment'>-- buffer window you want to keep next to the cycled window.</span> <a name="line-192"></a> <a name="line-193"></a><a name="rotFocusedUp"></a><span class='hs-comment'>-- | Rotate windows through the focused frame, excluding the \"next\" window.</span> <a name="line-194"></a><span class='hs-comment'>-- With, e.g. TwoPane, this allows cycling windows through either the</span> <a name="line-195"></a><span class='hs-comment'>-- master or slave pane, without changing the other frame. When the master</span> <a name="line-196"></a><span class='hs-comment'>-- is focused, the window below is skipped, when a non-master window is</span> <a name="line-197"></a><span class='hs-comment'>-- focused, the master is skipped.</span> <a name="line-198"></a><span class='hs-definition'>rotFocusedUp</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-199"></a><span class='hs-definition'>rotFocusedUp</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>windows</span> <span class='hs-varop'>.</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>modify'</span> <span class='hs-varop'>$</span> <span class='hs-varid'>rotFocused'</span> <span class='hs-varid'>rotUp</span> <a name="line-200"></a><a name="rotFocusedDown"></a><span class='hs-definition'>rotFocusedDown</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-201"></a><span class='hs-definition'>rotFocusedDown</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>windows</span> <span class='hs-varop'>.</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>modify'</span> <span class='hs-varop'>$</span> <span class='hs-varid'>rotFocused'</span> <span class='hs-varid'>rotDown</span> <a name="line-202"></a> <a name="line-203"></a><a name="rotFocused'"></a><span class='hs-comment'>-- | The focused rotation on a stack.</span> <a name="line-204"></a><span class='hs-definition'>rotFocused'</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-varid'>a</span> <a name="line-205"></a><span class='hs-definition'>rotFocused'</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>s</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>[]</span> <span class='hs-conid'>[]</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>s</span> <a name="line-206"></a><span class='hs-definition'>rotFocused'</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-varid'>t</span> <span class='hs-conid'>[]</span> <span class='hs-layout'>(</span><span class='hs-varid'>r</span><span class='hs-conop'>:</span><span class='hs-varid'>rs</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-varid'>t'</span> <span class='hs-conid'>[]</span> <span class='hs-layout'>(</span><span class='hs-varid'>r</span><span class='hs-conop'>:</span><span class='hs-varid'>rs'</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- Master has focus</span> <a name="line-207"></a> <span class='hs-keyword'>where</span> <span class='hs-layout'>(</span><span class='hs-varid'>t'</span><span class='hs-conop'>:</span><span class='hs-varid'>rs'</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-varid'>t</span><span class='hs-conop'>:</span><span class='hs-varid'>rs</span><span class='hs-layout'>)</span> <a name="line-208"></a><span class='hs-definition'>rotFocused'</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>rotSlaves'</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s</span> <span class='hs-comment'>-- otherwise</span> <a name="line-209"></a> <a name="line-210"></a> <a name="line-211"></a><a name="rotUnfocusedUp"></a><span class='hs-comment'>-- $unfocused</span> <a name="line-212"></a><span class='hs-comment'>-- Rotate windows through the unfocused frames. This is similar to</span> <a name="line-213"></a><span class='hs-comment'>-- @rotSlaves@, from "XMonad.Actions.RotSlaves", but excludes the current</span> <a name="line-214"></a><span class='hs-comment'>-- frame rather than master.</span> <a name="line-215"></a><span class='hs-definition'>rotUnfocusedUp</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-216"></a><span class='hs-definition'>rotUnfocusedUp</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>windows</span> <span class='hs-varop'>.</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>modify'</span> <span class='hs-varop'>$</span> <span class='hs-varid'>rotUnfocused'</span> <span class='hs-varid'>rotUp</span> <a name="line-217"></a><a name="rotUnfocusedDown"></a><span class='hs-definition'>rotUnfocusedDown</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span> <a name="line-218"></a><span class='hs-definition'>rotUnfocusedDown</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>windows</span> <span class='hs-varop'>.</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-varid'>modify'</span> <span class='hs-varop'>$</span> <span class='hs-varid'>rotUnfocused'</span> <span class='hs-varid'>rotDown</span> <a name="line-219"></a> <a name="line-220"></a><a name="rotUnfocused'"></a><span class='hs-comment'>-- | The unfocused rotation on a stack.</span> <a name="line-221"></a><span class='hs-definition'>rotUnfocused'</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-varid'>a</span> <a name="line-222"></a><span class='hs-definition'>rotUnfocused'</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>s</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>[]</span> <span class='hs-conid'>[]</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>s</span> <a name="line-223"></a><span class='hs-definition'>rotUnfocused'</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-keyword'>_</span> <span class='hs-conid'>[]</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>rotSlaves'</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s</span> <span class='hs-comment'>-- Master has focus</span> <a name="line-224"></a><span class='hs-definition'>rotUnfocused'</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-varid'>t</span> <span class='hs-varid'>ls</span> <span class='hs-varid'>rs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>W</span><span class='hs-varop'>.</span><span class='hs-conid'>Stack</span> <span class='hs-varid'>t</span> <span class='hs-layout'>(</span><span class='hs-varid'>reverse</span> <span class='hs-varid'>revls'</span><span class='hs-layout'>)</span> <span class='hs-varid'>rs'</span> <span class='hs-comment'>-- otherwise</span> <a name="line-225"></a> <span class='hs-keyword'>where</span> <span class='hs-layout'>(</span><span class='hs-varid'>master</span><span class='hs-conop'>:</span><span class='hs-varid'>revls</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>reverse</span> <span class='hs-varid'>ls</span> <a name="line-226"></a> <span class='hs-layout'>(</span><span class='hs-varid'>revls'</span><span class='hs-layout'>,</span><span class='hs-varid'>rs'</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>splitAt</span> <span class='hs-layout'>(</span><span class='hs-varid'>length</span> <span class='hs-varid'>ls</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varop'>$</span> <span class='hs-varid'>master</span><span class='hs-conop'>:</span><span class='hs-varid'>revls</span> <span class='hs-varop'>++</span> <span class='hs-varid'>rs</span><span class='hs-layout'>)</span> <a name="line-227"></a> <a name="line-228"></a><a name="rotUp"></a><span class='hs-comment'>-- $generic</span> <a name="line-229"></a><span class='hs-comment'>-- Generic list rotations</span> <a name="line-230"></a><span class='hs-definition'>rotUp</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <a name="line-231"></a><span class='hs-definition'>rotUp</span> <span class='hs-varid'>l</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>tail</span> <span class='hs-varid'>l</span> <span class='hs-varop'>++</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>head</span> <span class='hs-varid'>l</span><span class='hs-keyglyph'>]</span> <a name="line-232"></a><a name="rotDown"></a><span class='hs-definition'>rotDown</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <a name="line-233"></a><span class='hs-definition'>rotDown</span> <span class='hs-varid'>l</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>last</span> <span class='hs-varid'>l</span> <span class='hs-conop'>:</span> <span class='hs-varid'>init</span> <span class='hs-varid'>l</span> </pre></body> </html>