2 * Window Maker window manager
4 * Copyright (c) 1997-2003 Alfredo K. Kojima
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 * You should have received a copy of the GNU General Public License along
17 * with this program; if not, write to the Free Software Foundation, Inc.,
18 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21 #ifndef WINDOWMAKER_H_
22 #define WINDOWMAKER_H_
27 #include <WINGs/WINGs.h>
33 WCLASS_WINDOW
= 1, /* managed client windows */
34 WCLASS_MENU
= 2, /* root menus */
36 WCLASS_DUMMYWINDOW
= 4, /* window that holds window group leader */
37 WCLASS_MINIWINDOW
= 5,
40 WCLASS_TEXT_INPUT
= 8,
46 * generic window levels (a superset of the N*XTSTEP ones)
47 * Applications should use levels between WMDesktopLevel and
48 * WMScreensaverLevel anything boyond that range is allowed,
52 WMBackLevel
= INT_MIN
+1, /* Very lowest level */
53 WMDesktopLevel
= -1000, /* Lowest level of normal use */
61 WMFullscreenLevel
= 50,
64 WMScreensaverLevel
= 1000,
65 WMOuterSpaceLevel
= INT_MAX
69 * WObjDescriptor will be used by the event dispatcher to
70 * send events to a particular object through the methods in the
71 * method table. If all objects of the same class share the
72 * same methods, the class method table should be used, otherwise
73 * a new method table must be created for each object.
74 * It is also assigned to find the parent structure of a given
75 * window (like the WWindow or WMenu for a button)
78 typedef struct WObjDescriptor
{
79 void *self
; /* the object that will be called */
81 void (*handle_expose
)(struct WObjDescriptor
*sender
, XEvent
*event
);
83 void (*handle_mousedown
)(struct WObjDescriptor
*sender
, XEvent
*event
);
85 void (*handle_anything
)(struct WObjDescriptor
*sender
, XEvent
*event
);
87 void (*handle_enternotify
)(struct WObjDescriptor
*sender
, XEvent
*event
);
88 void (*handle_leavenotify
)(struct WObjDescriptor
*sender
, XEvent
*event
);
90 WClassType parent_type
; /* type code of the parent */
91 void *parent
; /* parent object (WWindow or WMenu) */
100 WSRestartPreparationMode
104 /* internal buttons */
106 #define WBUT_BROKENCLOSE 1
107 #define WBUT_ICONIFY 2
109 #ifdef XKB_BUTTON_HINT
110 #define WBUT_XKBGROUP1 4
111 #define WBUT_XKBGROUP2 5
112 #define WBUT_XKBGROUP3 6
113 #define WBUT_XKBGROUP4 7
114 #define PRED_BPIXMAPS 8 /* reserved for 4 groups */
116 #define PRED_BPIXMAPS 4 /* count of WBUT icons */
117 #endif /* XKB_BUTTON_HINT */
120 #define WCUR_DEFAULT 0
121 #define WCUR_NORMAL 0
123 #define WCUR_RESIZE 2
124 #define WCUR_TOPLEFTRESIZE 3
125 #define WCUR_TOPRIGHTRESIZE 4
126 #define WCUR_BOTTOMLEFTRESIZE 5
127 #define WCUR_BOTTOMRIGHTRESIZE 6
128 #define WCUR_VERTICALRESIZE 7
129 #define WCUR_HORIZONRESIZE 8
131 #define WCUR_ARROW 10
132 #define WCUR_QUESTION 11
134 #define WCUR_SELECT 13
136 #define WCUR_EMPTY 15
139 /* geometry displays */
140 #define WDIS_NEW 0 /* new style */
141 #define WDIS_CENTER 1 /* center of screen */
142 #define WDIS_TOPLEFT 2 /* top left corner of screen */
143 #define WDIS_FRAME_CENTER 3 /* center of the frame */
146 /* keyboard input focus mode */
150 /* colormap change mode */
152 #define WCM_POINTER 1
154 /* window placement mode */
156 #define WPM_CASCADE 1
161 /* text justification */
166 /* iconification styles */
171 #define WIS_RANDOM 4 /* secret */
173 /* switchmenu actions */
175 #define ACTION_REMOVE 1
176 #define ACTION_CHANGE 2
177 #define ACTION_CHANGE_WORKSPACE 3
178 #define ACTION_CHANGE_STATE 4
182 #define SPEED_ULTRAFAST 0
184 #define SPEED_MEDIUM 2
186 #define SPEED_ULTRASLOW 4
191 #define WS_UNFOCUSED 1
192 #define WS_PFOCUSED 2
194 /* clip title colors */
195 #define CLIP_NORMAL 0
196 #define CLIP_COLLAPSED 1
199 /* icon yard position */
210 #define MS_SINGLE_TEXTURE 1
213 /* workspace actions */
215 #define WA_SELECT_WINDOWS 1
216 #define WA_OPEN_APPMENU 2
217 #define WA_OPEN_WINLISTMENU 3
218 #define WA_SWITCH_WORKSPACES 4
220 /* workspace display position */
226 #define WD_TOPRIGHT 5
227 #define WD_BOTTOMLEFT 6
228 #define WD_BOTTOMRIGHT 7
235 /* workspace border position */
237 #define WB_LEFTRIGHT 1
238 #define WB_TOPBOTTOM 2
239 #define WB_ALLDIRS (WB_LEFTRIGHT|WB_TOPBOTTOM)
243 #define WSTATE_NORMAL 0
244 #define WSTATE_NEED_EXIT 1
245 #define WSTATE_NEED_RESTART 2
246 #define WSTATE_EXITING 3
247 #define WSTATE_RESTARTING 4
248 #define WSTATE_MODAL 5
249 #define WSTATE_NEED_REREAD 6
252 #define WCHECK_STATE(state) (state == WProgramState)
255 #define WCHANGE_STATE(nstate) {\
256 if (WProgramState == WSTATE_NORMAL\
257 || nstate != WSTATE_MODAL)\
258 WProgramState = (nstate); \
259 if (WProgramSigState != 0)\
260 WProgramState = WProgramSigState;\
264 /* only call inside signal handlers, with signals blocked */
265 #define SIG_WCHANGE_STATE(nstate) {\
266 WProgramSigState = (nstate);\
267 WProgramState = (nstate);\
271 /* Flags for the Window Maker state when restarting/crash situations */
272 #define WFLAGS_NONE (0)
273 #define WFLAGS_CRASHED (1<<0)
279 #define NOTIFICATION(n) char *WN##n = #n
281 #define NOTIFICATION(n) extern char *WN##n
284 NOTIFICATION(WindowAppearanceSettingsChanged
);
286 NOTIFICATION(IconAppearanceSettingsChanged
);
288 NOTIFICATION(IconTileSettingsChanged
);
290 NOTIFICATION(MenuAppearanceSettingsChanged
);
292 NOTIFICATION(MenuTitleAppearanceSettingsChanged
);
295 /* appearance settings clientdata flags */
297 WFontSettings
= 1 << 0,
298 WTextureSettings
= 1 << 1,
299 WColorSettings
= 1 << 2
309 typedef struct WCoord
{
313 typedef struct WPreferences
{
314 char *pixmap_path
; /* : separated list of paths to find pixmaps */
315 char *icon_path
; /* : separated list of paths to find icons */
316 WMArray
*fallbackWMs
; /* fallback window manager list */
317 char *logger_shell
; /* shell to log child stdi/o */
318 RImage
*button_images
; /* titlebar button images */
319 char smooth_workspace_back
;
320 signed char size_display
; /* display type for resize geometry */
321 signed char move_display
; /* display type for move geometry */
322 signed char window_placement
; /* window placement mode */
323 signed char colormap_mode
; /* colormap focus mode */
324 signed char focus_mode
; /* window focusing mode */
326 char opaque_move
; /* update window position during move */
327 char opaque_resize
; /* update window position during resize */
328 char opaque_move_resize_keyboard
; /* update window position during move,resize with keyboard */
329 char wrap_menus
; /* wrap menus at edge of screen */
330 char scrollable_menus
; /* let them be scrolled */
331 char align_menus
; /* align menu with their parents */
332 char use_saveunders
; /* turn on SaveUnders for menus, icons etc. */
333 char no_window_over_dock
;
334 char no_window_over_icons
;
335 WCoord window_place_origin
; /* Offset for windows placed on screen */
337 char constrain_window_size
; /* don't let windows get bigger than screen */
338 char windows_cycling
; /* windoze cycling */
339 char circ_raise
; /* raise window after Alt-tabbing */
340 char ignore_focus_click
;
341 char open_transients_with_parent
; /* open transient window in same workspace as parent */
342 signed char title_justification
; /* titlebar text alignment */
343 int window_title_clearance
;
344 int menu_title_clearance
;
345 int menu_text_clearance
;
346 char multi_byte_text
;
347 #ifdef KEEP_XKB_LOCK_STATUS
350 char no_dithering
; /* use dithering or not */
351 char no_animations
; /* enable/disable animations */
352 char no_autowrap
; /* wrap workspace when window is moved
355 char auto_arrange_icons
; /* automagically arrange icons */
356 char icon_box_position
; /* position to place icons */
357 signed char iconification_style
; /* position to place icons */
358 char disable_root_mouse
; /* disable button events in root window */
359 char auto_focus
; /* focus window when it's mapped */
360 char *icon_back_file
; /* background image for icons */
362 WCoord
*root_menu_pos
; /* initial position of the root menu*/
363 WCoord
*app_menu_pos
;
364 WCoord
*win_menu_pos
;
366 signed char icon_yard
; /* aka iconbox */
368 int raise_delay
; /* delay for autoraise. 0 is disabled */
369 int cmap_size
; /* size of dithering colormap in colors per channel */
371 int icon_size
; /* size of the icon */
372 signed char menu_style
; /* menu decoration style */
373 signed char workspace_name_display_position
;
374 unsigned int modifier_mask
; /* mask to use as kbd modifier */
375 char *modifier_labels
[7]; /* Names of the modifiers */
378 char ws_advance
; /* Create new workspace and advance */
379 char ws_cycle
; /* Cycle existing workspaces */
380 char save_session_on_exit
; /* automatically save session on exit */
381 char sticky_icons
; /* If miniwindows will be onmipresent */
382 char dont_confirm_kill
; /* do not confirm Kill application */
383 char disable_miniwindows
;
384 char dont_blink
; /* do not blink icon selection */
386 /* Appearance options */
387 char new_style
; /* Use newstyle buttons */
388 char superfluous
; /* Use superfluous things */
390 /* root window mouse bindings */
391 signed char mouse_button1
; /* action for left mouse button */
392 signed char mouse_button2
; /* action for middle mouse button */
393 signed char mouse_button3
; /* action for right mouse button */
394 signed char mouse_wheel
; /* action for mouse wheel */
398 char miniwin_balloon
;
399 char appicon_balloon
;
403 int dblclick_time
; /* double click delay time in ms */
406 signed char menu_scroll_speed
; /* how fast menus are scrolled */
408 /* animate icon sliding */
409 signed char icon_slide_speed
; /* icon slide animation speed */
411 /* shading animation */
412 signed char shade_speed
;
414 /* bouncing animation */
415 char bounce_appicons_when_urgent
;
416 char raise_appicons_when_bouncing
;
419 int resize_increment
;
422 unsigned int workspace_border_size
; /* Size in pixels of the workspace border */
423 char workspace_border_position
; /* Where to leave a workspace border */
424 char single_click
; /* single click to lauch applications */
425 int history_lines
; /* history of "Run..." dialog */
426 char cycle_active_head_only
; /* Cycle only windows on the active head */
429 RImage
*swbackImage
[9];
434 unsigned int nodock
:1; /* don't display the dock */
435 unsigned int noclip
:1; /* don't display the clip */
436 unsigned int nocpp
:1; /* don't use cpp */
437 unsigned int noupdates
:1; /* don't require ~/GNUstep (-static) */
438 unsigned int noautolaunch
:1; /* don't autolaunch apps */
439 unsigned int norestore
:1; /* don't restore session */
440 unsigned int create_stdcmap
:1; /* create std colormap */
442 unsigned int nopolling
:1; /* don't poll the defaults database for changes */
444 unsigned int restarting
:2;
445 } flags
; /* internal flags */
450 /****** Global Variables ******/
452 extern char *ProgName
;
453 extern unsigned int ValidModMask
;
454 extern char WProgramState
;
455 extern char WProgramSigState
;
458 /****** Global Functions ******/
459 extern void wAbort(Bool dumpCore
);
462 /****** Notifications ******/
463 extern const char *WMNManaged
;
464 extern const char *WMNUnmanaged
;
465 extern const char *WMNChangedWorkspace
;
466 extern const char *WMNChangedState
;
467 extern const char *WMNChangedFocus
;
468 extern const char *WMNChangedStacking
;
469 extern const char *WMNChangedName
;
471 extern const char *WMNWorkspaceCreated
;
472 extern const char *WMNWorkspaceDestroyed
;
473 extern const char *WMNWorkspaceChanged
;
474 extern const char *WMNWorkspaceNameChanged
;
476 extern const char *WMNResetStacking
;