<?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/CycleRecentWS.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.CycleRecentWS</span>
<a name="line-4"></a><span class='hs-comment'>-- Copyright : (c) Michal Janeczek <janeczek@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 : Michal Janeczek <janeczek@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 through most recently used workspaces</span>
<a name="line-12"></a><span class='hs-comment'>-- with repeated presses of a single key (as long as modifier key is</span>
<a name="line-13"></a><span class='hs-comment'>-- held down). This is similar to how many window managers handle</span>
<a name="line-14"></a><span class='hs-comment'>-- window switching.</span>
<a name="line-15"></a><span class='hs-comment'>--</span>
<a name="line-16"></a><span class='hs-comment'>-----------------------------------------------------------------------------</span>
<a name="line-17"></a>
<a name="line-18"></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'>CycleRecentWS</span> <span class='hs-layout'>(</span>
<a name="line-19"></a> <span class='hs-comment'>-- * Usage</span>
<a name="line-20"></a> <span class='hs-comment'>-- $usage</span>
<a name="line-21"></a> <span class='hs-varid'>cycleRecentWS</span><span class='hs-layout'>,</span>
<a name="line-22"></a> <span class='hs-varid'>cycleWindowSets</span>
<a name="line-23"></a><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-24"></a>
<a name="line-25"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span> <span class='hs-varid'>hiding</span> <span class='hs-layout'>(</span><span class='hs-varid'>workspaces</span><span class='hs-layout'>)</span>
<a name="line-26"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>XMonad</span><span class='hs-varop'>.</span><span class='hs-conid'>StackSet</span>
<a name="line-27"></a>
<a name="line-28"></a><span class='hs-comment'>-- $usage</span>
<a name="line-29"></a><span class='hs-comment'>-- You can use this module with the following in your @~\/.xmonad\/xmonad.hs@ file:</span>
<a name="line-30"></a><span class='hs-comment'>--</span>
<a name="line-31"></a><span class='hs-comment'>-- > import XMonad.Actions.CycleRecentWS</span>
<a name="line-32"></a><span class='hs-comment'>-- ></span>
<a name="line-33"></a><span class='hs-comment'>-- > , ((modm, xK_Tab), cycleRecentWS [xK_Alt_L] xK_Tab xK_grave)</span>
<a name="line-34"></a><span class='hs-comment'>--</span>
<a name="line-35"></a><span class='hs-comment'>-- For detailed instructions on editing your key bindings, see</span>
<a name="line-36"></a><span class='hs-comment'>-- "XMonad.Doc.Extending#Editing_key_bindings".</span>
<a name="line-37"></a>
<a name="line-38"></a><a name="cycleRecentWS"></a><span class='hs-comment'>-- | Cycle through most recent workspaces with repeated presses of a key, while</span>
<a name="line-39"></a><span class='hs-comment'>-- a modifier key is held down. The recency of workspaces previewed while browsing</span>
<a name="line-40"></a><span class='hs-comment'>-- to the target workspace is not affected. That way a stack of most recently used</span>
<a name="line-41"></a><span class='hs-comment'>-- workspaces is maintained, similarly to how many window managers handle window</span>
<a name="line-42"></a><span class='hs-comment'>-- switching. For best effects use the same modkey+key combination as the one used</span>
<a name="line-43"></a><span class='hs-comment'>-- to invoke this action.</span>
<a name="line-44"></a><span class='hs-definition'>cycleRecentWS</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-45"></a> <span class='hs-comment'>-- As soon as one of them is released, the final switch is made.</span>
<a name="line-46"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>KeySym</span> <span class='hs-comment'>-- ^ Key used to switch to next (less recent) workspace.</span>
<a name="line-47"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>KeySym</span> <span class='hs-comment'>-- ^ Key used to switch to previous (more recent) workspace.</span>
<a name="line-48"></a> <span class='hs-comment'>-- If it's the same as the nextWorkspace key, it is effectively ignored.</span>
<a name="line-49"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span>
<a name="line-50"></a><span class='hs-definition'>cycleRecentWS</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>cycleWindowSets</span> <span class='hs-varid'>options</span>
<a name="line-51"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>options</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>map</span> <span class='hs-layout'>(</span><span class='hs-varid'>view</span> <span class='hs-varop'>`flip`</span> <span class='hs-varid'>w</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>recentTags</span> <span class='hs-varid'>w</span><span class='hs-layout'>)</span>
<a name="line-52"></a> <span class='hs-varid'>recentTags</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>map</span> <span class='hs-varid'>tag</span> <span class='hs-varop'>$</span> <span class='hs-varid'>tail</span> <span class='hs-layout'>(</span><span class='hs-varid'>workspaces</span> <span class='hs-varid'>w</span><span class='hs-layout'>)</span> <span class='hs-varop'>++</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>head</span> <span class='hs-layout'>(</span><span class='hs-varid'>workspaces</span> <span class='hs-varid'>w</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span>
<a name="line-53"></a>
<a name="line-54"></a>
<a name="line-55"></a><a name="cycref"></a><span class='hs-definition'>cycref</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-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span>
<a name="line-56"></a><span class='hs-definition'>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>
<a name="line-57"></a>
<a name="line-58"></a><a name="cycleWindowSets"></a><span class='hs-comment'>-- | Cycle through a finite list of WindowSets with repeated presses of a key, while</span>
<a name="line-59"></a><span class='hs-comment'>-- a modifier key is held down. For best effects use the same modkey+key combination</span>
<a name="line-60"></a><span class='hs-comment'>-- as the one used to invoke this action.</span>
<a name="line-61"></a><span class='hs-definition'>cycleWindowSets</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>WindowSet</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>WindowSet</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- ^ A function used to create a list of WindowSets to choose from</span>
<a name="line-62"></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 when invoking this action.</span>
<a name="line-63"></a> <span class='hs-comment'>-- As soon as one of them is released, the final WindowSet is chosen and the action exits.</span>
<a name="line-64"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>KeySym</span> <span class='hs-comment'>-- ^ Key used to preview next WindowSet from the list of generated options</span>
<a name="line-65"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>KeySym</span> <span class='hs-comment'>-- ^ Key used to preview previous WindowSet from the list of generated options.</span>
<a name="line-66"></a> <span class='hs-comment'>-- If it's the same as nextOption key, it is effectively ignored.</span>
<a name="line-67"></a> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>X</span> <span class='hs-conid'>()</span>
<a name="line-68"></a><span class='hs-definition'>cycleWindowSets</span> <span class='hs-varid'>genOptions</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-69"></a> <span class='hs-varid'>options</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>gets</span> <span class='hs-varop'>$</span> <span class='hs-varid'>genOptions</span> <span class='hs-varop'>.</span> <span class='hs-varid'>windowset</span>
<a name="line-70"></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-71"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>event</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>allocaXEvent</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>p</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span>
<a name="line-72"></a> <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-73"></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-74"></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-75"></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-76"></a> <span class='hs-keyword'>let</span> <span class='hs-varid'>setOption</span> <span class='hs-varid'>n</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>windows</span> <span class='hs-varop'>$</span> <span class='hs-varid'>const</span> <span class='hs-varop'>$</span> <span class='hs-varid'>options</span> <span class='hs-varop'>`cycref`</span> <span class='hs-varid'>n</span>
<a name="line-77"></a> <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> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>io</span> <span class='hs-varid'>event</span>
<a name="line-78"></a> <span class='hs-keyword'>case</span> <span class='hs-conid'>()</span> <span class='hs-keyword'>of</span>
<a name="line-79"></a> <span class='hs-conid'>()</span> <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'>setOption</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-80"></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'>setOption</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-81"></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-82"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>setOption</span> <span class='hs-varid'>n</span>
<a name="line-83"></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-84"></a> <span class='hs-varid'>setOption</span> <span class='hs-num'>0</span>
<a name="line-85"></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>
</pre></body>
</html>
