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"

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.