fvwm-2.6.5.tar.gz: .../FvwmCommand/scripts/focus-link.1

"Fossies" - the Fresh Open Source Software archive

Member "fvwm-2.6.5/modules/FvwmCommand/scripts/focus-link.1" of archive fvwm-2.6.5.tar.gz:

Description

This is a user programmable window focus script. It requires FvwmCommand version 1.5 or later. FvwmCommandS must be invoked from fvwm prior to this command.

This script can be invoked from a shell or from .fvwm2rc. For example.

AddToFunc "InitFunction"
+ "I" Exec exec xcb -n 4 -l vertical -g 240x180-0+530
+ "I" Exec sleep 2; $HOME/scripts/focus-link.pl

Sleep is used in order to avoid un-necessary reaction during initial window creation. Note, fvwm itself continues to run during these 2 seconds.

Default behavior is listed below. In order to change the behavior, modify user_function using user functions.

1.: When a window is opened up, focus the window and move the pointer to it. The parent window regains focus when a window is closed. Parenthood is determined when a window is opened. It is the last focused window with the same X class.
2.: #1 would not occur to AcroRead opening window.
3.: #1 would not occur when SkipMapping is set and the window is the only window of its class.
4.: For Netscape find dialog window, addition to #1, resize the window to 300x150 pixels and move it to East edge of the screen. Download/upload windows will not be focused nor be in focus link list.
5.: Move appletviewer to NorthWest corner.
6.: Xterm won’t focus back to its parent after closed.
7.: When a window is de-iconified, focus it and move the pointer.

User Functions

These are collection of functions a user can call from programmable section.

move_window [<id>] <direction>

move_window [<id>] <x> <y>

If <id> is prensent in hex format, then move <id> window. Otherwise, move the window in question.

If <y> is present, move window to <x> <y> in percentage of screen.

If ’p’ is appended to <width> or <height>, it specifies in pixel count. And, if <width’p’> or <height’p’> is lead with ’-’, it signifies that pixel count from right or bottom edge.

If <y> does not exist, <dir> must be one of North Northeast East Southeast South Southwest West Northwest to move window to edge.

resize_window [<id>] <width> <height>

Resize window to <width> and <height> in percentage of screen size.

If <id> is not null, resize <id>. Otherwise resize the window in question.

Letter ’p’ can be appended to <width> and <height> to specify in pixel count.

focus_window [<id>]

If <id> is not null, focus on <id>. Otherwise, focus on the window in question.

warp_to_window [<id>] [<x> <y>]

Move pointer to window.

If <id> is a window id, warp to <id>. Otherwise, warp to the window in question.

If <x> and <y> are present, warp to <x> and <y> percentage of window size down and in from the upper left hand corner.

Letter ’p’ can be appended to <width> and <height> to specify in pixel count.

class_matches <class> [<resource>]

Check if window class and optional resource match.

If arg1 is present, and if class matches with <class> and resource matches with <resource>, then return 1.

If arg1 is not present, and if class matches with <class> then return 1. Otherwise, return null.

window_flag [<id>] <flag>

Return 1 if <flag> is true in the window in question. If <id> is not null, check on <id>. Otherwise check on the window in question. <flag> must be a exact match to one of these:

StartIconic
OnTop
Sticky
WindowListSkip
SuppressIcon
NoiconTitle
Lenience
StickyIcon
CirculateSkipIcon
CirculateSkip
ClickToFocus
SloppyFocus
SkipMapping
Handles
Title
Mapped
Iconified
Transient
Visible
IconOurs
PixmapOurs
ShapedIcon
Maximized
WmTakeFocus
WmDeleteWindow
IconMoved
IconUnmapped
MapPending
HintOverride
MWMButtons
MWMBorders