<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <!--Rendered using the Haskell Html Library v0.2--> <HTML ><HEAD ><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8" ><TITLE >XMonad.Layout.LayoutHints</TITLE ><LINK HREF="haddock.css" REL="stylesheet" TYPE="text/css" ><SCRIPT SRC="haddock-util.js" TYPE="text/javascript" ></SCRIPT ><SCRIPT TYPE="text/javascript" >window.onload = function () {setSynopsis("mini_XMonad-Layout-LayoutHints.html")};</SCRIPT ></HEAD ><BODY ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="topbar" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD ><IMG SRC="haskell_icon.gif" WIDTH="16" HEIGHT="16" ALT=" " ></TD ><TD CLASS="title" >xmonad-contrib-0.9.1: Third party extensions for xmonad</TD ><TD CLASS="topbut" ><A HREF="src/XMonad-Layout-LayoutHints.html" >Source code</A ></TD ><TD CLASS="topbut" ><A HREF="index.html" >Contents</A ></TD ><TD CLASS="topbut" ><A HREF="doc-index.html" >Index</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="modulebar" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD ><FONT SIZE="6" >XMonad.Layout.LayoutHints</FONT ></TD ><TD ALIGN="right" ><TABLE CLASS="narrow" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="infohead" >Portability</TD ><TD CLASS="infoval" >unportable</TD ></TR ><TR ><TD CLASS="infohead" >Stability</TD ><TD CLASS="infoval" >unstable</TD ></TR ><TR ><TD CLASS="infohead" >Maintainer</TD ><TD CLASS="infoval" >none</TD ></TR ></TABLE ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="section4" ><B >Contents</B ></TD ></TR ><TR ><TD ><DL ><DT ><A HREF="#1" >usage </A ></DT ></DL ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="section1" >Description</TD ></TR ><TR ><TD CLASS="doc" >Make layouts respect size hints. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="section1" >Synopsis</TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="decl" ><A HREF="#v%3AlayoutHints" >layoutHints</A > :: <A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3ALayoutClass" >LayoutClass</A > l a => l a -> <A HREF="XMonad-Layout-LayoutModifier.html#t%3AModifiedLayout" >ModifiedLayout</A > <A HREF="XMonad-Layout-LayoutHints.html#t%3ALayoutHints" >LayoutHints</A > l a</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AlayoutHintsWithPlacement" >layoutHintsWithPlacement</A > :: <A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3ALayoutClass" >LayoutClass</A > l a => (<A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Prelude.html#t%3ADouble" >Double</A >, <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Prelude.html#t%3ADouble" >Double</A >) -> l a -> <A HREF="XMonad-Layout-LayoutModifier.html#t%3AModifiedLayout" >ModifiedLayout</A > <A HREF="XMonad-Layout-LayoutHints.html#t%3ALayoutHints" >LayoutHints</A > l a</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AlayoutHintsToCenter" >layoutHintsToCenter</A > :: <A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3ALayoutClass" >LayoutClass</A > l a => l a -> <A HREF="XMonad-Layout-LayoutModifier.html#t%3AModifiedLayout" >ModifiedLayout</A > LayoutHintsToCenter l a</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><SPAN CLASS="keyword" >data</SPAN > <A HREF="#t%3ALayoutHints" >LayoutHints</A > a</TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="section1" ><A NAME="1" ><A NAME="1" >usage </A ></A ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="doc" ><P >You can use this module with the following in your <TT >~/.xmonad/xmonad.hs</TT >: </P ><PRE > import XMonad.Layout.LayoutHints </PRE ><P >Then edit your <TT >layoutHook</TT > by adding the <TT ><A HREF="XMonad-Layout-LayoutHints.html#v%3AlayoutHints" >layoutHints</A ></TT > layout modifier to some layout: </P ><PRE > myLayout = layoutHints (Tall 1 (3/100) (1/2)) ||| Full ||| etc.. main = xmonad defaultConfig { layoutHook = myLayout } </PRE ><P >Or, to center the adapted window in its available area: </P ><PRE > myLayout = layoutHintsWithPlacement (0.5, 0.5) (Tall 1 (3/100) (1/2)) ||| Full ||| etc.. </PRE ><P >Or, to make a reasonable attempt to eliminate gaps between windows: </P ><PRE > myLayout = layoutHintsToCenter (Tall 1 (3/100) (1/2)) </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 ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:layoutHints" ><A NAME="v%3AlayoutHints" ></A ></A ><B >layoutHints</B > :: <A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3ALayoutClass" >LayoutClass</A > l a => l a -> <A HREF="XMonad-Layout-LayoutModifier.html#t%3AModifiedLayout" >ModifiedLayout</A > <A HREF="XMonad-Layout-LayoutHints.html#t%3ALayoutHints" >LayoutHints</A > l a</TD ><TD CLASS="declbut" ><A HREF="src/XMonad-Layout-LayoutHints.html#layoutHints" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:layoutHintsWithPlacement" ><A NAME="v%3AlayoutHintsWithPlacement" ></A ></A ><B >layoutHintsWithPlacement</B > :: <A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3ALayoutClass" >LayoutClass</A > l a => (<A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Prelude.html#t%3ADouble" >Double</A >, <A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Prelude.html#t%3ADouble" >Double</A >) -> l a -> <A HREF="XMonad-Layout-LayoutModifier.html#t%3AModifiedLayout" >ModifiedLayout</A > <A HREF="XMonad-Layout-LayoutHints.html#t%3ALayoutHints" >LayoutHints</A > l a</TD ><TD CLASS="declbut" ><A HREF="src/XMonad-Layout-LayoutHints.html#layoutHintsWithPlacement" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="doc" ><TT >layoutHintsWithPlacement (rx, ry) layout</TT > will adapt the sizes of a layout's windows according to their size hints, and position them inside their originally assigned area according to the <TT >rx</TT > and <TT >ry</TT > parameters. (0, 0) places the window at the top left, (1, 0) at the top right, (0.5, 0.5) at the center, etc. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><A NAME="v:layoutHintsToCenter" ><A NAME="v%3AlayoutHintsToCenter" ></A ></A ><B >layoutHintsToCenter</B > :: <A HREF="/usr/share/doc/ghc/html/libraries/xmonad-0.9.1/XMonad-Core.html#t%3ALayoutClass" >LayoutClass</A > l a => l a -> <A HREF="XMonad-Layout-LayoutModifier.html#t%3AModifiedLayout" >ModifiedLayout</A > LayoutHintsToCenter l a</TD ><TD CLASS="declbut" ><A HREF="src/XMonad-Layout-LayoutHints.html#layoutHintsToCenter" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="doc" ><P ><TT >layoutHintsToCenter layout</TT > applies hints, sliding the window to the center of the screen and expanding its neighbors to fill the gaps. Windows are never expanded in a way that increases overlap. </P ><P ><TT >layoutHintsToCenter</TT > only makes one pass at resizing the neighbors of hinted windows, so with some layouts (ex. the arrangement with two Mirror Tall stacked vertically), <TT >layoutHintsToCenter</TT > may leave some gaps. Simple layouts like Tall are unaffected. </P ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="topdecl" ><TABLE CLASS="declbar" ><TR ><TD CLASS="declname" ><SPAN CLASS="keyword" >data</SPAN > <A NAME="t:LayoutHints" ><A NAME="t%3ALayoutHints" ></A ></A ><B >LayoutHints</B > a </TD ><TD CLASS="declbut" ><A HREF="src/XMonad-Layout-LayoutHints.html#LayoutHints" >Source</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="section4" ><IMG SRC="minus.gif" CLASS="coll" ONCLICK="toggle(this,'i:LayoutHints')" ALT="show/hide" > Instances</TD ></TR ><TR ><TD CLASS="body" ><DIV ID="i:LayoutHints" STYLE="display:block;" ><TABLE CLASS="vanilla" CELLSPACING="1" CELLPADDING="0" ><TR ><TD CLASS="decl" ><A HREF="XMonad-Layout-LayoutModifier.html#t%3ALayoutModifier" >LayoutModifier</A > <A HREF="XMonad-Layout-LayoutHints.html#t%3ALayoutHints" >LayoutHints</A > <A HREF="/usr/share/doc/ghc/html/libraries/X11-1.5.0.0/Graphics-X11-Types.html#t%3AWindow" >Window</A ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Text-Read.html#t%3ARead" >Read</A > (<A HREF="XMonad-Layout-LayoutHints.html#t%3ALayoutHints" >LayoutHints</A > a)</TD ></TR ><TR ><TD CLASS="decl" ><A HREF="/usr/share/doc/ghc/html/libraries/base-4.2.0.2/Text-Show.html#t%3AShow" >Show</A > (<A HREF="XMonad-Layout-LayoutHints.html#t%3ALayoutHints" >LayoutHints</A > a)</TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="botbar" >Produced by <A HREF="http://www.haskell.org/haddock/" >Haddock</A > version 2.6.1</TD ></TR ></TABLE ></BODY ></HTML >