1 /* -*- indent-tabs-mode: nil; tab-width: 4; c-basic-offset: 4; -*-
3 action.h for the Openbox window manager
4 Copyright (c) 2003 Ben Jansens
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 See the COPYING file for a copy of the GNU General Public License.
24 #include "parser/parse.h"
28 typedef struct _ObAction ObAction;
30 /* These have to all have a Client* at the top even if they don't use it, so
31 that I can set it blindly later on. So every function will have a Client*
32 available (possibly NULL though) if it wants it.
38 OB_CLIENT_ACTION_OPTIONAL,
39 OB_CLIENT_ACTION_ALWAYS
43 ObClientActionReq client_action;
45 ObFrameContext context;
52 struct InteractiveAction {
58 struct InterDirectionalAction{
59 struct InteractiveAction inter;
60 ObDirection direction;
64 struct DirectionalAction{
66 ObDirection direction;
80 gboolean here; /* bring it to the current desktop */
83 struct MoveResizeRelative {
88 struct SendToDesktop {
94 struct SendToDesktopDirection {
95 struct InteractiveAction inter;
103 struct InteractiveAction inter;
108 struct AnyAction any;
109 gint layer; /* < 0 = below, 0 = normal, > 0 = above */
112 struct DesktopDirection {
113 struct InteractiveAction inter;
120 struct AnyAction any;
126 struct AnyAction any;
130 struct CycleWindows {
131 struct InteractiveAction inter;
138 struct AnyAction any;
143 struct AnyAction any;
144 struct InteractiveAction inter;
145 struct InterDirectionalAction interdiraction;
146 struct DirectionalAction diraction;
147 struct Execute execute;
148 struct ClientAction client;
149 struct Activate activate;
150 struct MoveResizeRelative relative;
151 struct SendToDesktop sendto;
152 struct SendToDesktopDirection sendtodir;
153 struct Desktop desktop;
154 struct DesktopDirection desktopdir;
155 struct MoveResize moveresize;
156 struct ShowMenu showmenu;
157 struct CycleWindows cycle;
159 struct Stacking stacking;
165 /* The func member acts like an enum to tell which one of the structs in
166 the data union are valid.
168 void (*func)(union ActionData *data);
169 union ActionData data;
172 /* Creates a new Action from the name of the action
173 A few action types need data set after making this call still. Check if
174 the returned action's "func" is one of these.
175 action_execute - the path needs to be set
176 action_restart - the path can optionally be set
177 action_desktop - the destination desktop needs to be set
178 action_send_to_desktop - the destination desktop needs to be set
179 action_move_relative_horz - the delta
180 action_move_relative_vert - the delta
181 action_resize_relative_horz - the delta
182 action_resize_relative_vert - the delta
185 ObAction* action_from_string(const gchar *name, ObUserAction uact);
186 ObAction* action_parse(ObParseInst *i, xmlDocPtr doc, xmlNodePtr node,
188 void action_ref(ObAction *a);
189 void action_unref(ObAction *a);
191 ObAction* action_copy(const ObAction *a);
193 /*! Executes a list of actions.
194 @param c The client associated with the action. Can be NULL.
195 @param state The keyboard modifiers state at the time the user action occured
196 @param button The mouse button used to execute the action.
197 @param x The x coord at which the user action occured.
198 @param y The y coord at which the user action occured.
199 @param cancel If the action is cancelling an interactive action. This only
200 affects interactive actions, but should generally always be FALSE.
201 @param done If the action is completing an interactive action. This only
202 affects interactive actions, but should generally always be FALSE.
204 void action_run_list(GSList *acts, struct _ObClient *c, ObFrameContext context,
205 guint state, guint button, gint x, gint y,
206 gboolean cancel, gboolean done);
208 #define action_run_mouse(a, c, n, s, b, x, y) \
209 action_run_list(a, c, n, s, b, x, y, FALSE, FALSE)
211 #define action_run_interactive(a, c, s, n, d) \
212 action_run_list(a, c, OB_FRAME_CONTEXT_NONE, s, 0, -1, -1, n, d)
214 #define action_run_key(a, c, s, x, y) \
215 action_run_list(a, c, OB_FRAME_CONTEXT_NONE, s, 0, x, y, FALSE, FALSE)
217 #define action_run(a, c, s) \
218 action_run_list(a, c, OB_FRAME_CONTEXT_NONE, s, 0, -1, -1, FALSE, FALSE)
220 void action_run_string(const gchar *name, struct _ObClient *c);
223 void action_execute(union ActionData *data);
225 void action_activate(union ActionData *data);
227 void action_focus(union ActionData *data);
229 void action_unfocus(union ActionData *data);
231 void action_iconify(union ActionData *data);
233 void action_focus_order_to_bottom(union ActionData *data);
235 void action_raiselower(union ActionData *data);
237 void action_raise(union ActionData *data);
239 void action_lower(union ActionData *data);
241 void action_close(union ActionData *data);
243 void action_kill(union ActionData *data);
245 void action_shade(union ActionData *data);
247 void action_shadelower(union ActionData *data);
249 void action_unshaderaise(union ActionData *data);
251 void action_unshade(union ActionData *data);
253 void action_toggle_shade(union ActionData *data);
255 void action_toggle_omnipresent(union ActionData *data);
256 /* MoveResizeRelative */
257 void action_move_relative_horz(union ActionData *data);
258 /* MoveResizeRelative */
259 void action_move_relative_vert(union ActionData *data);
261 void action_move_to_center(union ActionData *data);
262 /* MoveResizeRelative */
263 void action_resize_relative_horz(union ActionData *data);
264 /* MoveResizeRelative */
265 void action_resize_relative_vert(union ActionData *data);
267 void action_maximize_full(union ActionData *data);
269 void action_unmaximize_full(union ActionData *data);
271 void action_toggle_maximize_full(union ActionData *data);
273 void action_maximize_horz(union ActionData *data);
275 void action_unmaximize_horz(union ActionData *data);
277 void action_toggle_maximize_horz(union ActionData *data);
279 void action_maximize_vert(union ActionData *data);
281 void action_unmaximize_vert(union ActionData *data);
283 void action_toggle_maximize_vert(union ActionData *data);
285 void action_toggle_fullscreen(union ActionData *data);
287 void action_send_to_desktop(union ActionData *data);
288 /* SendToDesktopDirection */
289 void action_send_to_desktop_dir(union ActionData *data);
291 void action_desktop(union ActionData *data);
292 /* DesktopDirection */
293 void action_desktop_dir(union ActionData *data);
295 void action_desktop_last(union ActionData *data);
297 void action_toggle_decorations(union ActionData *data);
299 void action_moveresize(union ActionData *data);
301 void action_reconfigure(union ActionData *data);
303 void action_restart(union ActionData *data);
305 void action_exit(union ActionData *data);
307 void action_showmenu(union ActionData *data);
309 void action_cycle_windows(union ActionData *data);
310 /* InterDirectionalAction */
311 void action_directional_focus(union ActionData *data);
312 /* DirectionalAction */
313 void action_movetoedge(union ActionData *data);
314 /* DirectionalAction */
315 void action_growtoedge(union ActionData *data);
317 void action_send_to_layer(union ActionData *data);
319 void action_toggle_layer(union ActionData *data);
321 void action_toggle_dockautohide(union ActionData *data);
323 void action_toggle_show_desktop(union ActionData *data);
325 void action_show_desktop(union ActionData *data);
327 void action_unshow_desktop(union ActionData *data);