<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>XMonad.Actions.GridSelect</title><link href="ocean.css" rel="stylesheet" type="text/css" title="Ocean" /><script src="haddock-util.js" type="text/javascript"></script><script type="text/javascript">//<![CDATA[
window.onload = function () {pageLoad();setSynopsis("mini_XMonad-Actions-GridSelect.html");};
//]]>
</script></head><body><div id="package-header"><ul class="links" id="page-menu"><li><a href="src/XMonad-Actions-GridSelect.html">Source</a></li><li><a href="index.html">Contents</a></li><li><a href="doc-index.html">Index</a></li></ul><p class="caption">xmonad-contrib-0.11: Third party extensions for xmonad</p></div><div id="content"><div id="module-header"><table class="info"><tr><th>Portability</th><td>unportable</td></tr><tr><th>Stability</th><td>unstable</td></tr><tr><th>Maintainer</th><td>Clemens Fruhwirth <clemens@endorphin.org></td></tr><tr><th>Safe Haskell</th><td>None</td></tr></table><p class="caption">XMonad.Actions.GridSelect</p></div><div id="table-of-contents"><p class="caption">Contents</p><ul><li><a href="#g:1">Usage
</a><ul><li><a href="#g:2">Customizing
</a><ul><li><a href="#g:3">Using a common GSConfig
</a></li><li><a href="#g:4">Custom keybindings
</a></li></ul></li></ul></li><li><a href="#g:5">Configuration
</a></li><li><a href="#g:6">Variations on <code><a href="XMonad-Actions-GridSelect.html#v:gridselect">gridselect</a></code>
</a></li><li><a href="#g:7">Colorizers
</a></li><li><a href="#g:8">Navigation Mode assembly
</a></li><li><a href="#g:9">Built-in Navigation Mode
</a></li><li><a href="#g:10">Navigation Components
</a></li><li><a href="#g:11">Screenshots
</a></li><li><a href="#g:12">Types
</a></li></ul></div><div id="description"><p class="caption">Description</p><div class="doc"><p>GridSelect displays items(e.g. the opened windows) in a 2D grid and lets
the user select from it with the cursor/hjkl keys or the mouse.
</p></div></div><div id="synopsis"><p id="control.syn" class="caption expander" onclick="toggleSection('syn')">Synopsis</p><ul id="section.syn" class="hide" onclick="toggleSection('syn')"><li class="src short"><span class="keyword">data</span> <a href="#t:GSConfig">GSConfig</a> a = <a href="#v:GSConfig">GSConfig</a> {<ul class="subs"><li><a href="#v:gs_cellheight">gs_cellheight</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a></li><li><a href="#v:gs_cellwidth">gs_cellwidth</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a></li><li><a href="#v:gs_cellpadding">gs_cellpadding</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a></li><li><a href="#v:gs_colorizer">gs_colorizer</a> :: a -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Bool.html#t:Bool">Bool</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>)</li><li><a href="#v:gs_font">gs_font</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a></li><li><a href="#v:gs_navigate">gs_navigate</a> :: <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)</li><li><a href="#v:gs_originFractX">gs_originFractX</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Double">Double</a></li><li><a href="#v:gs_originFractY">gs_originFractY</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Double">Double</a></li></ul>}</li><li class="src short"><a href="#v:defaultGSConfig">defaultGSConfig</a> :: <a href="XMonad-Actions-GridSelect.html#t:HasColorizer">HasColorizer</a> a => <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> a</li><li class="src short"><span class="keyword">type</span> <a href="#t:TwoDPosition">TwoDPosition</a> = (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a>)</li><li class="src short"><a href="#v:buildDefaultGSConfig">buildDefaultGSConfig</a> :: (a -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Bool.html#t:Bool">Bool</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>)) -> <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> a</li><li class="src short"><a href="#v:gridselect">gridselect</a> :: <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> a -> [(<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, a)] -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)</li><li class="src short"><a href="#v:gridselectWindow">gridselectWindow</a> :: <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a>)</li><li class="src short"><a href="#v:withSelectedWindow">withSelectedWindow</a> :: (<a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a>) -> <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li><li class="src short"><a href="#v:bringSelected">bringSelected</a> :: <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li><li class="src short"><a href="#v:goToSelected">goToSelected</a> :: <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li><li class="src short"><a href="#v:gridselectWorkspace">gridselectWorkspace</a> :: <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:WorkspaceId">WorkspaceId</a> -> (<a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:WorkspaceId">WorkspaceId</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:WindowSet">WindowSet</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:WindowSet">WindowSet</a>) -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li><li class="src short"><a href="#v:spawnSelected">spawnSelected</a> :: <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a> -> [<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>] -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li><li class="src short"><a href="#v:runSelectedAction">runSelectedAction</a> :: <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> (<a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a>) -> [(<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a>)] -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li><li class="src short"><span class="keyword">class</span> <a href="#t:HasColorizer">HasColorizer</a> a <span class="keyword">where</span><ul class="subs"><li><a href="#v:defaultColorizer">defaultColorizer</a> :: a -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Bool.html#t:Bool">Bool</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>)</li></ul></li><li class="src short"><a href="#v:fromClassName">fromClassName</a> :: <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Bool.html#t:Bool">Bool</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>)</li><li class="src short"><a href="#v:stringColorizer">stringColorizer</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a> -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Bool.html#t:Bool">Bool</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>)</li><li class="src short"><a href="#v:colorRangeFromClassName">colorRangeFromClassName</a> :: (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>) -> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>) -> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>) -> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>) -> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>) -> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Bool.html#t:Bool">Bool</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>)</li><li class="src short"><span class="keyword">data</span> <a href="#t:TwoD">TwoD</a> a b</li><li class="src short"><a href="#v:makeXEventhandler">makeXEventhandler</a> :: ((<a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:KeySym">KeySym</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:KeyMask">KeyMask</a>) -> <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)) -> <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)</li><li class="src short"><a href="#v:shadowWithKeymap">shadowWithKeymap</a> :: <a href="/usr/share/doc/ghc/html/libraries/containers-0.4.2.1/Data-Map.html#t:Map">Map</a> (<a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:KeyMask">KeyMask</a>, <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:KeySym">KeySym</a>) a -> ((<a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:KeySym">KeySym</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:KeyMask">KeyMask</a>) -> a) -> (<a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:KeySym">KeySym</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:KeyMask">KeyMask</a>) -> a</li><li class="src short"><a href="#v:defaultNavigation">defaultNavigation</a> :: <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)</li><li class="src short"><a href="#v:substringSearch">substringSearch</a> :: <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a) -> <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)</li><li class="src short"><a href="#v:navNSearch">navNSearch</a> :: <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)</li><li class="src short"><a href="#v:setPos">setPos</a> :: (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a>) -> <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li><li class="src short"><a href="#v:move">move</a> :: (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a>) -> <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li><li class="src short"><a href="#v:moveNext">moveNext</a> :: <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li><li class="src short"><a href="#v:movePrev">movePrev</a> :: <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li><li class="src short"><a href="#v:select">select</a> :: <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)</li><li class="src short"><a href="#v:cancel">cancel</a> :: <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)</li><li class="src short"><a href="#v:transformSearchString">transformSearchString</a> :: (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a> -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>) -> <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a></li><li class="src short"><span class="keyword">data</span> <a href="#t:TwoDState">TwoDState</a> a</li></ul></div><div id="interface"><h1 id="g:1">Usage
</h1><div class="doc"><p>You can use this module with the following in your <code>~/.xmonad/xmonad.hs</code>:
</p><pre> import XMonad.Actions.GridSelect
</pre><p>Then add a keybinding, e.g.
</p><pre> , ((modm, xK_g), goToSelected defaultGSConfig)
</pre><p>This module also supports displaying arbitrary information in a grid and letting
the user select from it. E.g. to spawn an application from a given list, you
can use the following:
</p><pre> , ((modm, xK_s), spawnSelected defaultGSConfig ["xterm","gmplayer","gvim"])
</pre></div><h2 id="g:2">Customizing
</h2><h3 id="g:3">Using a common GSConfig
</h3><div class="doc"><p>It is possible to bind a <code>gsconfig</code> at top-level in your configuration. Like so:
</p><pre> -- the top of your config
{-# LANGUAGE NoMonomorphismRestriction #-}
import XMonad
...
gsconfig1 = defaultGSConfig { gs_cellheight = 30, gs_cellwidth = 100 }
</pre><p>An example where <code><a href="XMonad-Actions-GridSelect.html#v:buildDefaultGSConfig">buildDefaultGSConfig</a></code> is used instead of <code><a href="XMonad-Actions-GridSelect.html#v:defaultGSConfig">defaultGSConfig</a></code>
in order to specify a custom colorizer is <code>gsconfig2</code> (found in
<a href="XMonad-Actions-GridSelect.html#Colorizers">XMonad.Actions.GridSelect</a>):
</p><pre> gsconfig2 colorizer = (buildDefaultGSConfig colorizer) { gs_cellheight = 30, gs_cellwidth = 100 }
</pre><pre> -- | A green monochrome colorizer based on window class
greenColorizer = colorRangeFromClassName
black -- lowest inactive bg
(0x70,0xFF,0x70) -- highest inactive bg
black -- active bg
white -- inactive fg
white -- active fg
where black = minBound
white = maxBound
</pre><p>Then you can bind to:
</p><pre> ,((modm, xK_g), goToSelected $ gsconfig2 myWinColorizer)
,((modm, xK_p), spawnSelected $ spawnSelected defaultColorizer)
</pre></div><h3 id="g:4">Custom keybindings
</h3><div class="doc"><p>You can build you own navigation mode and submodes by combining the
exported action ingredients and assembling them using <code><a href="XMonad-Actions-GridSelect.html#v:makeXEventhandler">makeXEventhandler</a></code> and <code><a href="XMonad-Actions-GridSelect.html#v:shadowWithKeymap">shadowWithKeymap</a></code>.
</p><pre> myNavigation :: TwoD a (Maybe a)
myNavigation = makeXEventhandler $ shadowWithKeymap navKeyMap navDefaultHandler
where navKeyMap = M.fromList [
((0,xK_Escape), cancel)
,((0,xK_Return), select)
,((0,xK_slash) , substringSearch myNavigation)
,((0,xK_Left) , move (-1,0) >> myNavigation)
,((0,xK_h) , move (-1,0) >> myNavigation)
,((0,xK_Right) , move (1,0) >> myNavigation)
,((0,xK_l) , move (1,0) >> myNavigation)
,((0,xK_Down) , move (0,1) >> myNavigation)
,((0,xK_j) , move (0,1) >> myNavigation)
,((0,xK_Up) , move (0,-1) >> myNavigation)
,((0,xK_y) , move (-1,-1) >> myNavigation)
,((0,xK_i) , move (1,-1) >> myNavigation)
,((0,xK_n) , move (-1,1) >> myNavigation)
,((0,xK_m) , move (1,-1) >> myNavigation)
,((0,xK_space) , setPos (0,0) >> myNavigation)
]
-- The navigation handler ignores unknown key symbols
navDefaultHandler = const myNavigation
</pre><p>You can then define <code>gsconfig3</code> which may be used in exactly the same manner as <code>gsconfig1</code>:
</p><pre> gsconfig3 = defaultGSConfig
{ gs_cellheight = 30
, gs_cellwidth = 100
, gs_navigate = myNavigation
}
</pre></div><h1 id="g:5">Configuration
</h1><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:GSConfig" class="def">GSConfig</a> a <a href="src/XMonad-Actions-GridSelect.html#GSConfig" class="link">Source</a></p><div class="subs constructors"><p class="caption">Constructors</p><table><tr><td class="src"><a name="v:GSConfig" class="def">GSConfig</a></td><td class="doc empty"> </td></tr><tr><td colspan="2"><div class="subs fields"><p class="caption">Fields</p><dl><dt class="src"><a name="v:gs_cellheight" class="def">gs_cellheight</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a></dt><dd class="doc empty"> </dd><dt class="src"><a name="v:gs_cellwidth" class="def">gs_cellwidth</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a></dt><dd class="doc empty"> </dd><dt class="src"><a name="v:gs_cellpadding" class="def">gs_cellpadding</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a></dt><dd class="doc empty"> </dd><dt class="src"><a name="v:gs_colorizer" class="def">gs_colorizer</a> :: a -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Bool.html#t:Bool">Bool</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>)</dt><dd class="doc empty"> </dd><dt class="src"><a name="v:gs_font" class="def">gs_font</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a></dt><dd class="doc empty"> </dd><dt class="src"><a name="v:gs_navigate" class="def">gs_navigate</a> :: <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)</dt><dd class="doc empty"> </dd><dt class="src"><a name="v:gs_originFractX" class="def">gs_originFractX</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Double">Double</a></dt><dd class="doc empty"> </dd><dt class="src"><a name="v:gs_originFractY" class="def">gs_originFractY</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Double">Double</a></dt><dd class="doc empty"> </dd></dl><div class="clear"></div></div></td></tr></table></div></div><div class="top"><p class="src"><a name="v:defaultGSConfig" class="def">defaultGSConfig</a> :: <a href="XMonad-Actions-GridSelect.html#t:HasColorizer">HasColorizer</a> a => <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> a<a href="src/XMonad-Actions-GridSelect.html#defaultGSConfig" class="link">Source</a></p><div class="doc"><p>A basic configuration for <code><a href="XMonad-Actions-GridSelect.html#v:gridselect">gridselect</a></code>, with the colorizer chosen based on the type.
</p><p>If you want to replace the <code><a href="XMonad-Actions-GridSelect.html#v:gs_colorizer">gs_colorizer</a></code> field, use <code><a href="XMonad-Actions-GridSelect.html#v:buildDefaultGSConfig">buildDefaultGSConfig</a></code>
instead, to avoid ambiguous type variables.
</p></div></div><div class="top"><p class="src"><span class="keyword">type</span> <a name="t:TwoDPosition" class="def">TwoDPosition</a> = (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a>)<a href="src/XMonad-Actions-GridSelect.html#TwoDPosition" class="link">Source</a></p></div><div class="top"><p class="src"><a name="v:buildDefaultGSConfig" class="def">buildDefaultGSConfig</a> :: (a -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Bool.html#t:Bool">Bool</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>)) -> <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> a<a href="src/XMonad-Actions-GridSelect.html#buildDefaultGSConfig" class="link">Source</a></p><div class="doc"><p>Builds a default gs config from a colorizer function.
</p></div></div><h1 id="g:6">Variations on <code><a href="XMonad-Actions-GridSelect.html#v:gridselect">gridselect</a></code>
</h1><div class="top"><p class="src"><a name="v:gridselect" class="def">gridselect</a> :: <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> a -> [(<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, a)] -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)<a href="src/XMonad-Actions-GridSelect.html#gridselect" class="link">Source</a></p><div class="doc"><p>Brings up a 2D grid of elements in the center of the screen, and one can
select an element with cursors keys. The selected element is returned.
</p></div></div><div class="top"><p class="src"><a name="v:gridselectWindow" class="def">gridselectWindow</a> :: <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a>)<a href="src/XMonad-Actions-GridSelect.html#gridselectWindow" class="link">Source</a></p><div class="doc"><p>Like <code>gridSelect</code> but with the current windows and their titles as elements
</p></div></div><div class="top"><p class="src"><a name="v:withSelectedWindow" class="def">withSelectedWindow</a> :: (<a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a>) -> <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Actions-GridSelect.html#withSelectedWindow" class="link">Source</a></p><div class="doc"><p>Brings up a 2D grid of windows in the center of the screen, and one can
select a window with cursors keys. The selected window is then passed to
a callback function.
</p></div></div><div class="top"><p class="src"><a name="v:bringSelected" class="def">bringSelected</a> :: <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Actions-GridSelect.html#bringSelected" class="link">Source</a></p><div class="doc"><p>Brings selected window to the current workspace.
</p></div></div><div class="top"><p class="src"><a name="v:goToSelected" class="def">goToSelected</a> :: <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Actions-GridSelect.html#goToSelected" class="link">Source</a></p><div class="doc"><p>Switches to selected window's workspace and focuses that window.
</p></div></div><div class="top"><p class="src"><a name="v:gridselectWorkspace" class="def">gridselectWorkspace</a> :: <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:WorkspaceId">WorkspaceId</a> -> (<a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:WorkspaceId">WorkspaceId</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:WindowSet">WindowSet</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:WindowSet">WindowSet</a>) -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Actions-GridSelect.html#gridselectWorkspace" class="link">Source</a></p><div class="doc"><p>Select a workspace and view it using the given function
(normally <code><a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-StackSet.html#v:view">view</a></code> or <code><a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-StackSet.html#v:greedyView">greedyView</a></code>)
</p><p>Another option is to shift the current window to the selected workspace:
</p><pre> gridselectWorkspace (\ws -> W.greedyView ws . W.shift ws)
</pre></div></div><div class="top"><p class="src"><a name="v:spawnSelected" class="def">spawnSelected</a> :: <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a> -> [<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>] -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Actions-GridSelect.html#spawnSelected" class="link">Source</a></p><div class="doc"><p>Select an application to spawn from a given list
</p></div></div><div class="top"><p class="src"><a name="v:runSelectedAction" class="def">runSelectedAction</a> :: <a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a> (<a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a>) -> [(<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a>)] -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Actions-GridSelect.html#runSelectedAction" class="link">Source</a></p><div class="doc"><p>Select an action and run it in the X monad
</p></div></div><h1 id="g:7">Colorizers
</h1><div class="top"><p class="src"><span class="keyword">class</span> <a name="t:HasColorizer" class="def">HasColorizer</a> a <span class="keyword">where</span><a href="src/XMonad-Actions-GridSelect.html#HasColorizer" class="link">Source</a></p><div class="doc"><p>That is <code><a href="XMonad-Actions-GridSelect.html#v:fromClassName">fromClassName</a></code> if you are selecting a <code><a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a></code>, or
<code><a href="XMonad-Actions-GridSelect.html#v:defaultColorizer">defaultColorizer</a></code> if you are selecting a <code><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a></code>. The catch-all instance
<code>HasColorizer a</code> uses the <code><a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#v:focusedBorderColor">focusedBorderColor</a></code> and <code><a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#v:normalBorderColor">normalBorderColor</a></code>
colors.
</p></div><div class="subs methods"><p class="caption">Methods</p><p class="src"><a name="v:defaultColorizer" class="def">defaultColorizer</a> :: a -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Bool.html#t:Bool">Bool</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>)<a href="src/XMonad-Actions-GridSelect.html#defaultColorizer" class="link">Source</a></p></div><div class="subs instances"><p id="control.i:HasColorizer" class="caption collapser" onclick="toggleSection('i:HasColorizer')">Instances</p><div id="section.i:HasColorizer" class="show"><table><tr><td class="src"><a href="XMonad-Actions-GridSelect.html#t:HasColorizer">HasColorizer</a> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="XMonad-Actions-GridSelect.html#t:HasColorizer">HasColorizer</a> a</td><td class="doc empty"> </td></tr><tr><td class="src"><a href="XMonad-Actions-GridSelect.html#t:HasColorizer">HasColorizer</a> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><a name="v:fromClassName" class="def">fromClassName</a> :: <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a> -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Bool.html#t:Bool">Bool</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>)<a href="src/XMonad-Actions-GridSelect.html#fromClassName" class="link">Source</a></p><div class="doc"><p>Colorize a window depending on it's className.
</p></div></div><div class="top"><p class="src"><a name="v:stringColorizer" class="def">stringColorizer</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a> -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Bool.html#t:Bool">Bool</a> -> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>)<a href="src/XMonad-Actions-GridSelect.html#stringColorizer" class="link">Source</a></p><div class="doc"><p>Default colorizer for Strings
</p></div></div><div class="top"><p class="src"><a name="v:colorRangeFromClassName" class="def">colorRangeFromClassName</a><a href="src/XMonad-Actions-GridSelect.html#colorRangeFromClassName" class="link">Source</a></p><div class="subs arguments"><p class="caption">Arguments</p><table><tr><td class="src">:: (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>)</td><td class="doc"><p>Beginning of the color range
</p></td></tr><tr><td class="src">-> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>)</td><td class="doc"><p>End of the color range
</p></td></tr><tr><td class="src">-> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>)</td><td class="doc"><p>Background of the active window
</p></td></tr><tr><td class="src">-> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>)</td><td class="doc"><p>Inactive text color
</p></td></tr><tr><td class="src">-> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Word.html#t:Word8">Word8</a>)</td><td class="doc"><p>Active text color
</p></td></tr><tr><td class="src">-> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:Window">Window</a></td><td class="doc empty"> </td></tr><tr><td class="src">-> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Bool.html#t:Bool">Bool</a></td><td class="doc empty"> </td></tr><tr><td class="src">-> <a href="/usr/share/doc/ghc/html/libraries/xmonad-0.11/XMonad-Core.html#t:X">X</a> (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>)</td><td class="doc empty"> </td></tr></table></div><div class="doc"><p>A colorizer that picks a color inside a range,
and depending on the window's class.
</p></div></div><h1 id="g:8">Navigation Mode assembly
</h1><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:TwoD" class="def">TwoD</a> a b <a href="src/XMonad-Actions-GridSelect.html#TwoD" class="link">Source</a></p><div class="subs instances"><p id="control.i:TwoD" class="caption collapser" onclick="toggleSection('i:TwoD')">Instances</p><div id="section.i:TwoD" class="show"><table><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Control-Monad.html#t:Monad">Monad</a> (<a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a)</td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Control-Monad.html#t:Functor">Functor</a> (<a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a)</td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Control-Applicative.html#t:Applicative">Applicative</a> (<a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a)</td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/mtl-2.1.1/Control-Monad-State-Class.html#t:MonadState">MonadState</a> (<a href="XMonad-Actions-GridSelect.html#t:TwoDState">TwoDState</a> a) (<a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a)</td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><a name="v:makeXEventhandler" class="def">makeXEventhandler</a> :: ((<a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:KeySym">KeySym</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:KeyMask">KeyMask</a>) -> <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)) -> <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)<a href="src/XMonad-Actions-GridSelect.html#makeXEventhandler" class="link">Source</a></p><div class="doc"><p>Embeds a key handler into the X event handler that dispatches key
events to the key handler, while non-key event go to the standard
handler.
</p></div></div><div class="top"><p class="src"><a name="v:shadowWithKeymap" class="def">shadowWithKeymap</a> :: <a href="/usr/share/doc/ghc/html/libraries/containers-0.4.2.1/Data-Map.html#t:Map">Map</a> (<a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:KeyMask">KeyMask</a>, <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:KeySym">KeySym</a>) a -> ((<a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:KeySym">KeySym</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:KeyMask">KeyMask</a>) -> a) -> (<a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:KeySym">KeySym</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>, <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Types.html#t:KeyMask">KeyMask</a>) -> a<a href="src/XMonad-Actions-GridSelect.html#shadowWithKeymap" class="link">Source</a></p><div class="doc"><p>When the map contains (KeySym,KeyMask) tuple for the given event,
the associated action in the map associated shadows the default key
handler
</p></div></div><h1 id="g:9">Built-in Navigation Mode
</h1><div class="top"><p class="src"><a name="v:defaultNavigation" class="def">defaultNavigation</a> :: <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)<a href="src/XMonad-Actions-GridSelect.html#defaultNavigation" class="link">Source</a></p><div class="doc"><p>By default gridselect used the defaultNavigation action, which
binds left,right,up,down and vi-style h,l,j,k navigation. Return
quits gridselect, returning the selected element, while Escape
cancels the selection. Slash enters the substring search mode. In
substring search mode, every string-associated keystroke is
added to a search string, which narrows down the object
selection. Substring search mode comes back to regular navigation
via Return, while Escape cancels the search. If you want that
navigation style, add <code><a href="XMonad-Actions-GridSelect.html#v:defaultNavigation">defaultNavigation</a></code> as <code><a href="XMonad-Actions-GridSelect.html#v:gs_navigate">gs_navigate</a></code> to your
<code><a href="XMonad-Actions-GridSelect.html#t:GSConfig">GSConfig</a></code> object. This is done by <code><a href="XMonad-Actions-GridSelect.html#v:buildDefaultGSConfig">buildDefaultGSConfig</a></code> automatically.
</p></div></div><div class="top"><p class="src"><a name="v:substringSearch" class="def">substringSearch</a> :: <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a) -> <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)<a href="src/XMonad-Actions-GridSelect.html#substringSearch" class="link">Source</a></p><div class="doc"><p>Navigation submode used for substring search. It returns to the
first argument navigation style when the user hits Return.
</p></div></div><div class="top"><p class="src"><a name="v:navNSearch" class="def">navNSearch</a> :: <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)<a href="src/XMonad-Actions-GridSelect.html#navNSearch" class="link">Source</a></p><div class="doc"><p>This navigation style combines navigation and search into one mode at the cost of losing vi style
navigation. With this style, there is no substring search submode,
but every typed character is added to the substring search.
</p></div></div><h1 id="g:10">Navigation Components
</h1><div class="top"><p class="src"><a name="v:setPos" class="def">setPos</a> :: (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a>) -> <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Actions-GridSelect.html#setPos" class="link">Source</a></p><div class="doc"><p>Sets the absolute position of the cursor.
</p></div></div><div class="top"><p class="src"><a name="v:move" class="def">move</a> :: (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a>, <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Prelude.html#t:Integer">Integer</a>) -> <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Actions-GridSelect.html#move" class="link">Source</a></p><div class="doc"><p>Moves the cursor by the offsets specified
</p></div></div><div class="top"><p class="src"><a name="v:moveNext" class="def">moveNext</a> :: <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Actions-GridSelect.html#moveNext" class="link">Source</a></p></div><div class="top"><p class="src"><a name="v:movePrev" class="def">movePrev</a> :: <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Actions-GridSelect.html#movePrev" class="link">Source</a></p></div><div class="top"><p class="src"><a name="v:select" class="def">select</a> :: <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)<a href="src/XMonad-Actions-GridSelect.html#select" class="link">Source</a></p><div class="doc"><p>Closes gridselect returning the element under the cursor
</p></div></div><div class="top"><p class="src"><a name="v:cancel" class="def">cancel</a> :: <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Maybe.html#t:Maybe">Maybe</a> a)<a href="src/XMonad-Actions-GridSelect.html#cancel" class="link">Source</a></p><div class="doc"><p>Closes gridselect returning no element.
</p></div></div><div class="top"><p class="src"><a name="v:transformSearchString" class="def">transformSearchString</a> :: (<a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a> -> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-String.html#t:String">String</a>) -> <a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a <a href="/usr/share/doc/ghc/html/libraries/ghc-prim-0.2.0.0/GHC-Tuple.html#t:-40--41-">()</a><a href="src/XMonad-Actions-GridSelect.html#transformSearchString" class="link">Source</a></p><div class="doc"><p>Apply a transformation function the current search string
</p></div></div><h1 id="g:11">Screenshots
</h1><div class="doc"><p>Selecting a workspace:
</p><p><img src="http://haskell.org/wikiupload/a/a9/Xmonad-gridselect-workspace.png" />
</p><p>Selecting a window by title:
</p><p><img src="http://haskell.org/wikiupload/3/35/Xmonad-gridselect-window-aavogt.png" />
</p></div><h1 id="g:12">Types
</h1><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:TwoDState" class="def">TwoDState</a> a <a href="src/XMonad-Actions-GridSelect.html#TwoDState" class="link">Source</a></p><div class="subs instances"><p id="control.i:TwoDState" class="caption collapser" onclick="toggleSection('i:TwoDState')">Instances</p><div id="section.i:TwoDState" class="show"><table><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/mtl-2.1.1/Control-Monad-State-Class.html#t:MonadState">MonadState</a> (<a href="XMonad-Actions-GridSelect.html#t:TwoDState">TwoDState</a> a) (<a href="XMonad-Actions-GridSelect.html#t:TwoD">TwoD</a> a)</td><td class="doc empty"> </td></tr></table></div></div></div></div></div><div id="footer"><p>Produced by <a href="http://www.haskell.org/haddock/">Haddock</a> version 2.10.0</p></div></body></html>
