IceWM: Window Options

Next Previous Contents

## 14. Window Options

winoptions file is used to configure settings for individual application windows.

Each line in the file must be in one of the possible formats:

window_class.window_name.window_role.option: argument window_class.window_name.option: argument window_class.window_role.option: argument window_name.window_role.option: argument window_class.option: argument window_name.option: argument window_role.option: argument

Each window on the desktop has (should) class and name resources associated with it. Some more recent applications will also have a window role resource, though not all do. They can be determined using the `xprop` utility.

xprop should display a line like this when used on a toplevel window:

    WM_CLASS = "name", "class"

and may also display a line like this:

    WM_WINDOW_ROLE = "window role"

It's possible that an application's class and/or name contains the dot character (".") used by IceWM to separate class, name and role values. To lock it, precede it with the backslash character. In the following example, we suppose an application's window has the.class as its class value and the.name as its name value :

    the\.class.the\.name.option: argument

Options that can be set per window are as follows:

icon

  The name of the icon.

workspace

  Default workspace for window (number, counting from 0)

layer

  Default layer for the window. Layer can be one of the following strings:

  Desktop

    Desktop window. There should be only one window in this layer.

  Below

    Below default layer.

  Normal

    Default layer for the windows.

  OnTop

    Above the default.

  Dock

    Layer for windows docked to the edge of the screen.

  AboveDock

    Layer for the windows above the dock.

  Menu

    Layer for the windows above the dock.

  You can also use the numbers from `WinMgr.h`.

geometry

  Default geometry for window. This geometry should be specified in the X11-syntax, formal notation: [=][<width>{xX}<height>][{+-}<xoffset>{+-}<yoffset>]

tray

  Default tray option for the window. Affects both the tray and the task pane. Tray can be one of the following strings:

  Ignore

    Don't add an icon to the tray pane.

  Minimized

    Add an icon the the tray. Remove the task pane button when minimized.

  Exclusive

    Add an icon the the tray. Never create a task pane button .

allWorkspaces=0

  If set to 1, window will be visible on all workspaces.

ignoreWinList=0

  If set to 1, window will not appear in the window list.

ignoreTaskBar=0

  If set to 1, window will not appear on the task bar.

ignoreQuickSwitch=0

  If set to 1, window will not be accessible using QuickSwitch feature (Alt+Tab).

fullKeys=0

  If set to 1, the window manager leave more keys (Alt+F?) to the application.

fMove=1

  If set to 0, window will not be movable.

fResize=1

  If set to 0, window will not be resizable.

fClose=1

  If set to 0, window will not be closable.

fMinimize=1

  If set to 0, window will not be minimizable.

fMaximize=1

  If set to 0, window will not be maximizable.

fHide=1

  If set to 0, window will not be hidable.

fRollup=1

  If set to 0, window will not be shadable.

dTitleBar=1

  If set to 0, window will not have a title bar.

dSysMenu=1

  If set to 0, window will not have a system menu.

dBorder=1

  If set to 0, window will not have a border.

dResize=1

  If set to 0, window will not have a resize border.

dClose=1

  If set to 0, window will not have a close button.

dMinimize=1

  If set to 0, window will not have a minimize button.

dMaximize=1

  If set to 0, window will not have a maximize button.

noFocusOnAppRaise

  if set to 1, window will not automatically get focus as application raises it.

ignoreNoFocusHint

  if set to 1, icewm will focus even if the window does not handle input.

doNotCover=0

  if set to 1, this window will limit the workspace available for regular applications. window has to be sticky at the moment to make it work

forcedClose=0

  if set to 1 and the application had not registered WM_DELETE_WINDOW, a close confirmation dialog won't be offered upon closing the window.

Next Previous Contents