<!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.Layout.MagicFocus</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-Layout-MagicFocus.html");};
//]]>
</script></head><body><div id="package-header"><ul class="links" id="page-menu"><li><a href="src/XMonad-Layout-MagicFocus.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>Peter De Wachter <pdewacht@gmail.com></td></tr><tr><th>Safe Haskell</th><td>Safe-Infered</td></tr></table><p class="caption">XMonad.Layout.MagicFocus</p></div><div id="table-of-contents"><p class="caption">Contents</p><ul><li><a href="#g:1">Usage
</a></li></ul></div><div id="description"><p class="caption">Description</p><div class="doc"><p>Automagically put the focused window in the master area.
</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"><a href="#v:magicFocus">magicFocus</a> :: l a -> <a href="XMonad-Layout-LayoutModifier.html#t:ModifiedLayout">ModifiedLayout</a> <a href="XMonad-Layout-MagicFocus.html#t:MagicFocus">MagicFocus</a> l a</li><li class="src short"><a href="#v:promoteWarp">promoteWarp</a> :: <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Xlib-Extras.html#t:Event">Event</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-Monoid.html#t:All">All</a></li><li class="src short"><a href="#v:promoteWarp-39-">promoteWarp'</a> :: <a href="XMonad-Actions-UpdatePointer.html#t:PointerPosition">PointerPosition</a> -> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Xlib-Extras.html#t:Event">Event</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-Monoid.html#t:All">All</a></li><li class="src short"><a href="#v:followOnlyIf">followOnlyIf</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-Bool.html#t:Bool">Bool</a> -> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Xlib-Extras.html#t:Event">Event</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-Monoid.html#t:All">All</a></li><li class="src short"><a href="#v:disableFollowOnWS">disableFollowOnWS</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:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Bool.html#t:Bool">Bool</a></li><li class="src short"><span class="keyword">data</span> <a href="#t:MagicFocus">MagicFocus</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.Layout.MagicFocus
</pre><p>Then edit your <code>layoutHook</code> by adding the magicFocus layout
modifier:
</p><pre> myLayout = magicFocus (Tall 1 (3/100) (1/2)) ||| Full ||| etc..
main = xmonad defaultConfig { layoutHook = myLayout,
handleEventHook = promoteWarp }
</pre><p>For more detailed instructions on editing the layoutHook see:
</p><p><a href="XMonad-Doc-Extending.html#Editing_the_layout_hook">XMonad.Doc.Extending</a>
</p></div><div class="top"><p class="src"><a name="v:magicFocus" class="def">magicFocus</a> :: l a -> <a href="XMonad-Layout-LayoutModifier.html#t:ModifiedLayout">ModifiedLayout</a> <a href="XMonad-Layout-MagicFocus.html#t:MagicFocus">MagicFocus</a> l a<a href="src/XMonad-Layout-MagicFocus.html#magicFocus" class="link">Source</a></p><div class="doc"><p>Create a new layout which automagically puts the focused window
in the master area.
</p></div></div><div class="top"><p class="src"><a name="v:promoteWarp" class="def">promoteWarp</a> :: <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Xlib-Extras.html#t:Event">Event</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-Monoid.html#t:All">All</a><a href="src/XMonad-Layout-MagicFocus.html#promoteWarp" class="link">Source</a></p><div class="doc"><p>An eventHook that overrides the normal focusFollowsMouse. When the mouse
it moved to another window, that window is replaced as the master, and the
mouse is warped to inside the new master.
</p><p>It prevents infinite loops when focusFollowsMouse is true (the default), and
MagicFocus is in use when changing focus with the mouse.
</p><p>This eventHook does nothing when there are floating windows on the current
workspace.
</p></div></div><div class="top"><p class="src"><a name="v:promoteWarp-39-" class="def">promoteWarp'</a> :: <a href="XMonad-Actions-UpdatePointer.html#t:PointerPosition">PointerPosition</a> -> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Xlib-Extras.html#t:Event">Event</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-Monoid.html#t:All">All</a><a href="src/XMonad-Layout-MagicFocus.html#promoteWarp%27" class="link">Source</a></p><div class="doc"><p>promoteWarp' allows you to specify an arbitrary PointerPosition to apply
when the mouse enters another window.
</p></div></div><div class="top"><p class="src"><a name="v:followOnlyIf" class="def">followOnlyIf</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-Bool.html#t:Bool">Bool</a> -> <a href="/usr/share/doc/ghc/html/libraries/X11-1.6.0/Graphics-X11-Xlib-Extras.html#t:Event">Event</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-Monoid.html#t:All">All</a><a href="src/XMonad-Layout-MagicFocus.html#followOnlyIf" class="link">Source</a></p><div class="doc"><p>Another event hook to override the focusFollowsMouse and make the pointer
only follow if a given condition is satisfied. This could be used to disable
focusFollowsMouse only for given workspaces or layouts.
Beware that your focusFollowsMouse setting is ignored if you use this event hook.
</p></div></div><div class="top"><p class="src"><a name="v:disableFollowOnWS" class="def">disableFollowOnWS</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:X">X</a> <a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Data-Bool.html#t:Bool">Bool</a><a href="src/XMonad-Layout-MagicFocus.html#disableFollowOnWS" class="link">Source</a></p><div class="doc"><p>Disables focusFollow on the given workspaces:
</p></div></div><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:MagicFocus" class="def">MagicFocus</a> a <a href="src/XMonad-Layout-MagicFocus.html#MagicFocus" class="link">Source</a></p><div class="subs instances"><p id="control.i:MagicFocus" class="caption collapser" onclick="toggleSection('i:MagicFocus')">Instances</p><div id="section.i:MagicFocus" class="show"><table><tr><td class="src"><a href="XMonad-Layout-LayoutModifier.html#t:LayoutModifier">LayoutModifier</a> <a href="XMonad-Layout-MagicFocus.html#t:MagicFocus">MagicFocus</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><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.5.0.0/Text-Read.html#t:Read">Read</a> (<a href="XMonad-Layout-MagicFocus.html#t:MagicFocus">MagicFocus</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/Text-Show.html#t:Show">Show</a> (<a href="XMonad-Layout-MagicFocus.html#t:MagicFocus">MagicFocus</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>
