xmonad-0.8.1: A tiling window managerContentsIndex
XMonad.Operations
Portabilitynot portable, Typeable deriving, mtl, posix
Stabilityunstable
Maintainerdons@cse.unsw.edu.au
Description
Operations.
Synopsis
manage :: Window -> X ()
unmanage :: Window -> X ()
kill :: X ()
windows :: (WindowSet -> WindowSet) -> X ()
setWMState :: Window -> Int -> X ()
hide :: Window -> X ()
reveal :: Window -> X ()
clientMask :: EventMask
setInitialProperties :: Window -> X ()
refresh :: X ()
clearEvents :: EventMask -> X ()
tileWindow :: Window -> Rectangle -> X ()
containedIn :: Rectangle -> Rectangle -> Bool
nubScreens :: [Rectangle] -> [Rectangle]
getCleanedScreenInfo :: MonadIO m => Display -> m [Rectangle]
rescreen :: X ()
setButtonGrab :: Bool -> Window -> X ()
setTopFocus :: X ()
focus :: Window -> X ()
setFocusX :: Window -> X ()
sendMessage :: Message a => a -> X ()
broadcastMessage :: Message a => a -> X ()
sendMessageWithNoRefresh :: Message a => a -> Workspace WorkspaceId (Layout Window) Window -> X ()
updateLayout :: WorkspaceId -> Maybe (Layout Window) -> X ()
setLayout :: Layout Window -> X ()
screenWorkspace :: ScreenId -> X (Maybe WorkspaceId)
withFocused :: (Window -> X ()) -> X ()
isClient :: Window -> X Bool
extraModifiers :: X [KeyMask]
cleanMask :: KeyMask -> X KeyMask
initColor :: Display -> String -> IO (Maybe Pixel)
restart :: String -> Bool -> X ()
floatLocation :: Window -> X (ScreenId, RationalRect)
float :: Window -> X ()
mouseDrag :: (Position -> Position -> X ()) -> X () -> X ()
mouseMoveWindow :: Window -> X ()
mouseResizeWindow :: Window -> X ()
type D = (Dimension, Dimension)
mkAdjust :: Window -> X (D -> D)
applySizeHints :: Integral a => Dimension -> SizeHints -> (a, a) -> D
applySizeHintsContents :: Integral a => SizeHints -> (a, a) -> D
applySizeHints' :: SizeHints -> D -> D
applyAspectHint :: (D, D) -> D -> D
applyResizeIncHint :: D -> D -> D
applyMaxSizeHint :: D -> D -> D
Documentation
manage :: Window -> X ()

Window manager operations manage. Add a new window to be managed in the current workspace. Bring it into focus.

Whether the window is already managed, or not, it is mapped, has its border set, and its event mask set.

unmanage :: Window -> X ()
unmanage. A window no longer exists, remove it from the window list, on whatever workspace it is.
kill :: X ()

Kill the currently focused client. If we do kill it, we'll get a delete notify back from X.

There are two ways to delete a window. Either just kill it, or if it supports the delete protocol, send a delete event (e.g. firefox)

windows :: (WindowSet -> WindowSet) -> X ()
windows. Modify the current window list with a pure function, and refresh
setWMState :: Window -> Int -> X ()
setWMState. set the WM_STATE property
hide :: Window -> X ()
hide. Hide a window by unmapping it, and setting Iconified.
reveal :: Window -> X ()
reveal. Show a window by mapping it and setting Normal this is harmless if the window was already visible
clientMask :: EventMask
The client events that xmonad is interested in
setInitialProperties :: Window -> X ()
Set some properties when we initially gain control of a window
refresh :: X ()

refresh. Render the currently visible workspaces, as determined by the StackSet. Also, set focus to the focused window.

This is our view operation (MVC), in that it pretty prints our model with X calls.

clearEvents :: EventMask -> X ()
clearEvents. Remove all events of a given type from the event queue.
tileWindow :: Window -> Rectangle -> X ()
tileWindow. Moves and resizes w such that it fits inside the given rectangle, including its border.
containedIn :: Rectangle -> Rectangle -> Bool
Returns True if the first rectangle is contained within, but not equal to the second.
nubScreens :: [Rectangle] -> [Rectangle]
Given a list of screens, remove all duplicated screens and screens that are entirely contained within another.
getCleanedScreenInfo :: MonadIO m => Display -> m [Rectangle]
Cleans the list of screens according to the rules documented for nubScreens.
rescreen :: X ()
rescreen. The screen configuration may have changed (due to xrandr), update the state and refresh the screen, and reset the gap.
setButtonGrab :: Bool -> Window -> X ()
setButtonGrab. Tell whether or not to intercept clicks on a given window
setTopFocus :: X ()
Set the focus to the window on top of the stack, or root
focus :: Window -> X ()
Set focus explicitly to window w if it is managed by us, or root. This happens if X notices we've moved the mouse (and perhaps moved the mouse to a new screen).
setFocusX :: Window -> X ()
Call X to set the keyboard focus details.
sendMessage :: Message a => a -> X ()
Throw a message to the current LayoutClass possibly modifying how we layout the windows, then refresh.
broadcastMessage :: Message a => a -> X ()
Send a message to all layouts, without refreshing.
sendMessageWithNoRefresh :: Message a => a -> Workspace WorkspaceId (Layout Window) Window -> X ()
Send a message to a layout, without refreshing.
updateLayout :: WorkspaceId -> Maybe (Layout Window) -> X ()
Update the layout field of a workspace
setLayout :: Layout Window -> X ()
Set the layout of the currently viewed workspace
screenWorkspace :: ScreenId -> X (Maybe WorkspaceId)
Return workspace visible on screen sc, or Nothing.
withFocused :: (Window -> X ()) -> X ()
Apply an X operation to the currently focused window, if there is one.
isClient :: Window -> X Bool
True if window is under management by us
extraModifiers :: X [KeyMask]
Combinations of extra modifier masks we need to grab keys/buttons for. (numlock and capslock)
cleanMask :: KeyMask -> X KeyMask
Strip numlock/capslock from a mask
initColor :: Display -> String -> IO (Maybe Pixel)
Get the Pixel value for a named color
restart :: String -> Bool -> X ()
restart name resume. Attempt to restart xmonad by executing the program name. If resume is True, restart with the current window state. When executing another window manager, resume should be False.
floatLocation :: Window -> X (ScreenId, RationalRect)

Floating layer support

Given a window, find the screen it is located on, and compute the geometry of that window wrt. that screen.

float :: Window -> X ()
Make a tiled window floating, using its suggested rectangle
mouseDrag :: (Position -> Position -> X ()) -> X () -> X ()
Accumulate mouse motion events
mouseMoveWindow :: Window -> X ()
XXX comment me
mouseResizeWindow :: Window -> X ()
XXX comment me
type D = (Dimension, Dimension)
Support for window size hints
mkAdjust :: Window -> X (D -> D)
Given a window, build an adjuster function that will reduce the given dimensions according to the window's border width and size hints.
applySizeHints :: Integral a => Dimension -> SizeHints -> (a, a) -> D
Reduce the dimensions if needed to comply to the given SizeHints, taking window borders into account.
applySizeHintsContents :: Integral a => SizeHints -> (a, a) -> D
Reduce the dimensions if needed to comply to the given SizeHints.
applySizeHints' :: SizeHints -> D -> D
XXX comment me
applyAspectHint :: (D, D) -> D -> D
Reduce the dimensions so their aspect ratio falls between the two given aspect ratios.
applyResizeIncHint :: D -> D -> D
Reduce the dimensions so they are a multiple of the size increments.
applyMaxSizeHint :: D -> D -> D
Reduce the dimensions if they exceed the given maximum dimensions.
Produced by Haddock version 2.1.0