Project

General

Profile

unexist.dev

subtle

Assorted tidbits and projects

Clients » History » Version 5

« Previous - Version 5/16 (diff) - Next » - Current version
Anonymous, 06/23/2011 05:36 PM


Clients\015\012\015\012{{>toc}}\015\012\015\012Clients are the actual toplevel windows subtle manages.\015\012\015\012h2. Types\015\012\015\012There are several different window types that set some of the client modes automatically, this can be used in tagging to mimic this behavior.\015\012\015\012Following types exist:\015\012\015\012{{needs(r2905)}}\015\012\015\012h3. Normal\015\012\015\012This is the default type of windows and no special modes are set for this.\015\012\015\012h3. Desktop\015\012\015\012Desktop type windows are usually file managers that display icons and stay at the bottom of the window stack. They have no window title, no border and can neither be resized nor moved.\015\012\015\012*Used modes*: Borderless, Fixed, Fullscreen\015\012\015\012h3. Dock\015\012\015\012Dock type windows are usually panels that provide different kind of information and accessibility.\015\012\015\012{{info(Currently there is no special handling of this window type.)}}\015\012\015\012h3. Toolbar\015\012\015\012Toolbar windows are usually windows with either text or icons menu entries.\015\012\015\012{{info(Currently there is no special handling of this window type.)}}\015\012\015\012h3. Splash\015\012\015\012Splash windows are usually silly progress windows that are a placeholder until an app is ready.\015\012\015\012*Used modes*: Stick, Float\015\012\015\012h3. Dialog\015\012\015\012Dialog windows are usually any kind of setting or message windows.\015\012\015\012*Used modes*: Stick, Float, Center\015\012\015\012h2. Modes\015\012\015\012A window can have different modes that influence the appearance and behavior of it either globally or just for tagged views. subtle and subtler indicate this mode with a special character.\015\012\015\012Following modes exist:\015\012\015\012h3. Global\015\012\015\012{{needs(r2900)}}\015\012\015\012h4. Borderless\015\012\015\012This mode disables the window border of the window and uses the additional space for the window.\015\012\015\012{{needs(r1)}}\015\012\015\012h4. Center\015\012\015\012This mode centers the window on the screen.\015\012\015\012{{needs(r2890)}}\015\012\015\012h4. Fixed\015\012\015\012This mode prevents the window from being resized, that means that all actions (like fullscreen and gravity) that would change the size are ignored.\015\012\015\012{{info(This mode is indicated by a !.)}}\015\012\015\012h4. Resize\015\012\015\012This mode enables the honoring of size hints, that are hints for the window manager about special size preferences and constraints like an aspect ratio.\015\012\015\012{{info(This mode is indicated by a ~.)}}\015\012\015\012h4. Sticky\015\012\015\012This mode overrides the tagging and makes the window visible on all views on the same screen. When a window isn't normally visible on a certain view the current gravity instead of the default gravity will be used.\015\012\015\012{{info(This mode is indicated by a *.)}}\015\012\015\012{{needs(r2871)}}\015\012\015\012h4. Zaphod\015\012\015\012This mode spans a window across all screens regardless if the window is normally visible there.\015\012\015\012{{info(This mode is indicated by a =.)}}\015\012\015\012h3. Per view\015\012\015\012h4. Floating\015\012\015\012This mode looses the window from the gravity grid and raises it above other windows. Size hints are automatically honored in floating mode and windows can be moved and resized. (Doing that with gravitated windows enables floating mode)\015\012\015\012{{info(This mode is indicated by a ^.)}}\015\012\015\012h4. Fullscreen\015\012\015\012This mode let's a window use the total space of screen, that includes all space that is normally used for panels and strut.\015\012\015\012{{info(This mode is indicated by a +.)}}\015\012\015\012h4. Urgent\015\012\015\012This mode automatically draws pointer and keyboard focus and highlights the panel title and any view. Once the window gets focus this mode is removed.