3 \index{clientwin-do-manage-alt@\code{clientwin_do_manage_alt}}
4 \hookname{clientwin_do_manage_alt}
5 \hookparams{(WClientWin, table)}
7 Called when we want to manage a new client window.
8 The table argument contains the following fields:
10 \begin{tabularx}{\linewidth}{llX}
11 \tabhead{Field & Type & Description}
12 \var{switchto} & bool & Do we want to switch to the client window. \\
13 \var{jumpto} & bool & Do we want to jump to the client window. \\
14 \var{userpos} & bool & Geometry set by user. \\
15 \var{dockapp} & bool & Client window is a dock-app. \\
16 \var{maprq} & bool & Map request (and not initialisation scan). \\
17 \var{gravity} & number & Window gravity. \\
18 \var{geom} & table & Requested geometry; \var{x}, \var{y}, \var{w}, \var{h}.\\
19 \var{tfor} & WClientWin & Transient for window.
22 This hook is not called in protected mode and can be used for
23 arbitrary placement policies (deciding in which workspace a new
24 \type{WClientWin} should go). In this case, you can call
28 where \var{reg} is the region where the window should go, and
29 \var{cwin} is the first argument of the function added to the
36 \index{clientwin-mapped-hook@\code{clientwin_mapped_hook}}
37 \hookname{clientwin_mapped_hook}
38 \hookparams{WClientWin}
40 Called when we have started to manage a client window.
46 \index{clientwin-property-change-hook@\code{clientwin_property_change_hook}}
47 \hookname{clientwin_property_change_hook}
48 \hookparams{(WClientWin, integer)}
50 Called when the property identified by the parameter atom id
51 (integer) has changed on a client window.
57 \index{clientwin-unmapped-hook@\code{clientwin_unmapped_hook}}
58 \hookname{clientwin_unmapped_hook}
61 Called when we no longer manage a client window. The parameter
62 is the X ID of the window; see \fnref{WClientWin.xid}.
68 \index{frame-managed-changed-hook@\code{frame_managed_changed_hook}}
69 \hookname{frame_managed_changed_hook}
72 Called when there are changes in the objects managed by a frame
73 or their order. The table parameter has the following fields:
75 \begin{tabularx}{\linewidth}{llX}
76 \tabhead{Field & Type & Description}
77 \var{reg} & WFrame & The frame in question \\
78 \var{mode} & string & \codestr{switchonly}, \codestr{reorder},
79 \codestr{add} or \codestr{remove} \\
80 \var{sw} & bool & Switch occurred \\
81 \var{sub} & WRegion & The managed region (primarily) affected \\
88 \index{ioncore-sigchld-hook@\code{ioncore_sigchld_hook}}
89 \hookname{ioncore_sigchld_hook}
92 Called when a child process has exited. The parameter
93 is the PID of the process.
98 \index{ioncore-deinit-hook@\code{ioncore_deinit_hook}}
99 \hookname{ioncore_deinit_hook}
102 Called when Ion is deinitialising and about to quit.
106 %ioncore_handle_event_alt -- not available to lua side
109 \index{ioncore-post-layout-setup-hook@\code{ioncore_post_layout_setup_hook}}
110 \hookname{ioncore_post_layout_setup_hook}
113 Called when Ion has done all initialisation and is almost ready to
114 enter the main-loop, except no windows are yet being managed.
120 \index{ioncore-snapshot-hook@\code{ioncore_snapshot_hook}}
121 \hookname{ioncore_snapshot_hook}
124 Called to signal scripts and modules to save their state (if any).
130 \index{ioncore-submap-ungrab-hook@\code{ioncore_submap_ungrab_hook}}
131 \hookname{ioncore_submap_ungrab_hook}
134 This hook is used to signal whenever Ion leaves the submap grab mode.
140 \index{tiling-placement-alt@\code{tiling_placement_alt}}
141 \hookname{tiling_placement_alt}
144 Called when a client window is about to be managed by a \type{WTiling}
145 to allow for alternative placement policies. The table has the
147 \begin{tabularx}{\linewidth}{llX}
148 \tabhead{Field & Type & Description}
149 \var{tiling} & \type{WTiling} & The tiling \\
150 \var{reg} & \type{WRegion} & The region (always a WClientWin at
151 the moment) to be placed \\
152 \var{mp} & \type{table} & This table contains the same fields as
153 the parameter of \fnref{clientwin_do_manage_alt} \\
154 \var{res_frame} & \type{WFrame} & A successful handler should
155 return the target frame here. \\
157 This hook is just for placing within a given workspace after the
158 workspace has been decided by the default workspace selection
159 policy. It is called in protected mode. For arbitrary placement
160 policies, \fnref{clientwin_do_manage_alt} should be used; it
161 isn't called in protected mode,
167 \index{region-do-warp-alt@\code{region_do_warp_alt}}
168 \hookname{region_do_warp_alt}
171 This alt-hook exist to allow for alternative pointer warping
178 \index{screen-managed-changed-hook@\code{screen_managed_changed_hook}}
179 \hookname{screen_managed_changed_hook}
182 Called when there are changes in the objects managed by a screen
183 or their order. The table parameter is similar to that of
184 \fnref{frame_managed_changed_hook}.
190 \index{region-notify-hook@\code{region_notify_hook}}
191 \hookname{region_notify_hook}
192 \hookparams{(WRegion, string)}
194 Signalled when something (minor) has changed in relation to
195 the first parameter region. The string argument gives the
198 \begin{tabularx}{\linewidth}{lX}
199 \tabhead{String & Description}
200 \code{deinit} & The region is about to be deinitialised. \\
201 \code{activated} & The region has received focus. \\
202 \code{inactivated} & The region has lost focus. \\
203 \code{activity} & There's been activity in the region itself. \\
204 \code{sub_activity} & There's been activity in some sub-region. \\
205 \code{name} & The name of the region has changed. \\
206 \code{unset_manager} & The region no longer has a manager. \\
207 \code{set_manager} & The region now has a manager. \\
208 \code{tag} & Tagging state has changed. \\
209 \code{pseudoactivated} & The region has become pseudo-active
211 \code{pseudoinactivated} & The region is no longer pseudo-active. \\
214 A region is pseudo-active, when a) it is itself not active (does
215 not not have the focus, and may not even have a window that could
216 have it), but b) some region managed by it is active.