/* Metacity X display handler */ /* * Copyright (C) 2001 Havoc Pennington * * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License as * published by the Free Software Foundation; either version 2 of the * License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA * 02111-1307, USA. */ #ifndef META_DISPLAY_H #define META_DISPLAY_H #include #include #include "eventqueue.h" #include "common.h" #define meta_XFree(p) do { if ((p)) XFree ((p)); } while (0) /* this doesn't really belong here, oh well. */ typedef struct _MetaRectangle MetaRectangle; struct _MetaRectangle { int x; int y; int width; int height; }; typedef struct _MetaDisplay MetaDisplay; typedef struct _MetaFrame MetaFrame; typedef struct _MetaScreen MetaScreen; typedef struct _MetaStack MetaStack; typedef struct _MetaUISlave MetaUISlave; typedef struct _MetaWindow MetaWindow; typedef struct _MetaWorkspace MetaWorkspace; typedef void (* MetaWindowPingFunc) (MetaDisplay *display, Window xwindow, gpointer user_data); #define _NET_WM_STATE_REMOVE 0 /* remove/unset property */ #define _NET_WM_STATE_ADD 1 /* add/set property */ #define _NET_WM_STATE_TOGGLE 2 /* toggle property */ /* This is basically a bogus number, just has to be large enough * to handle the expected case of the alt+tab operation, where * we want to ignore serials from UnmapNotify on the tab popup, * and the LeaveNotify/EnterNotify from the pointer ungrab */ #define N_IGNORED_SERIALS 4 struct _MetaDisplay { char *name; Display *xdisplay; Window leader_window; Atom atom_net_wm_name; Atom atom_wm_protocols; Atom atom_wm_take_focus; Atom atom_wm_delete_window; Atom atom_wm_state; Atom atom_net_close_window; Atom atom_net_wm_state; Atom atom_motif_wm_hints; Atom atom_net_wm_state_shaded; Atom atom_net_wm_state_maximized_horz; Atom atom_net_wm_state_maximized_vert; Atom atom_net_wm_desktop; Atom atom_net_number_of_desktops; Atom atom_wm_change_state; Atom atom_sm_client_id; Atom atom_wm_client_leader; Atom atom_wm_window_role; Atom atom_net_current_desktop; Atom atom_net_supporting_wm_check; Atom atom_net_supported; Atom atom_net_wm_window_type; Atom atom_net_wm_window_type_desktop; Atom atom_net_wm_window_type_dock; Atom atom_net_wm_window_type_toolbar; Atom atom_net_wm_window_type_menu; Atom atom_net_wm_window_type_dialog; Atom atom_net_wm_window_type_normal; Atom atom_net_wm_state_modal; Atom atom_net_client_list; Atom atom_net_client_list_stacking; Atom atom_net_wm_state_skip_taskbar; Atom atom_net_wm_state_skip_pager; Atom atom_win_workspace; Atom atom_win_layer; Atom atom_win_protocols; Atom atom_win_supporting_wm_check; Atom atom_net_wm_icon_name; Atom atom_net_wm_icon; Atom atom_net_wm_icon_geometry; Atom atom_utf8_string; Atom atom_wm_icon_size; Atom atom_kwm_win_icon; Atom atom_net_wm_moveresize; Atom atom_net_active_window; Atom atom_metacity_restart_message; Atom atom_net_wm_strut; Atom atom_win_hints; Atom atom_metacity_reload_theme_message; Atom atom_metacity_set_keybindings_message; Atom atom_net_wm_state_hidden; Atom atom_net_wm_window_type_utility; Atom atom_net_wm_window_type_splashscreen; Atom atom_net_wm_ping; Atom atom_net_wm_pid; Atom atom_wm_client_machine; Atom atom_net_wm_state_fullscreen; /* This is the actual window from focus events, * not the one we last set */ MetaWindow *focus_window; /* Previous focus window */ MetaWindow *prev_focus_window; GList *workspaces; guint showing_desktop : 1; guint static_gravity_works : 1; /*< private-ish >*/ MetaEventQueue *events; GSList *screens; GHashTable *window_ids; int error_traps; int (* error_trap_handler) (Display *display, XErrorEvent *error); int server_grab_count; /* This window holds the focus when we don't want to focus * any actual clients */ Window no_focus_window; /* for double click */ int double_click_time; Time last_button_time; Window last_button_xwindow; int last_button_num; guint is_double_click : 1; /* serials of leave/unmap events that may * correspond to an enter event we should * ignore */ unsigned long ignored_serials[N_IGNORED_SERIALS]; Window ungrab_should_not_cause_focus_window; guint32 current_time; /* Pings which we're waiting for a reply from */ GSList *pending_pings; /* current window operation */ MetaGrabOp grab_op; MetaWindow *grab_window; Window grab_xwindow; int grab_button; int grab_root_x; int grab_root_y; gulong grab_mask; guint grab_have_pointer : 1; guint grab_have_keyboard : 1; MetaRectangle grab_initial_window_pos; }; gboolean meta_display_open (const char *name); void meta_display_close (MetaDisplay *display); MetaScreen* meta_display_screen_for_root (MetaDisplay *display, Window xroot); MetaScreen* meta_display_screen_for_x_screen (MetaDisplay *display, Screen *screen); void meta_display_grab (MetaDisplay *display); void meta_display_ungrab (MetaDisplay *display); gboolean meta_display_is_double_click (MetaDisplay *display); /* A given MetaWindow may have various X windows that "belong" * to it, such as the frame window. */ MetaWindow* meta_display_lookup_x_window (MetaDisplay *display, Window xwindow); void meta_display_register_x_window (MetaDisplay *display, Window *xwindowp, MetaWindow *window); void meta_display_unregister_x_window (MetaDisplay *display, Window xwindow); GSList* meta_display_list_windows (MetaDisplay *display); MetaDisplay* meta_display_for_x_display (Display *xdisplay); GSList* meta_displays_list (void); MetaWorkspace* meta_display_get_workspace_by_index (MetaDisplay *display, int index); MetaWorkspace* meta_display_get_workspace_by_screen_index (MetaDisplay *display, MetaScreen *screen, int index); Cursor meta_display_create_x_cursor (MetaDisplay *display, MetaCursor cursor); gboolean meta_display_begin_grab_op (MetaDisplay *display, MetaWindow *window, MetaGrabOp op, gboolean pointer_already_grabbed, int button, gulong modmask, Time timestamp, int root_x, int root_y); void meta_display_end_grab_op (MetaDisplay *display, Time timestamp); void meta_display_grab_window_buttons (MetaDisplay *display, Window xwindow); void meta_display_ungrab_window_buttons (MetaDisplay *display, Window xwindow); void meta_display_grab_focus_window_button (MetaDisplay *display, Window xwindow); void meta_display_ungrab_focus_window_button (MetaDisplay *display, Window xwindow); /* make a request to ensure the event serial has changed */ void meta_display_increment_event_serial (MetaDisplay *display); void meta_display_update_active_window_hint (MetaDisplay *display); /* Show/hide the desktop (temporarily hide all windows) */ void meta_display_show_desktop (MetaDisplay *display); void meta_display_unshow_desktop (MetaDisplay *display); guint32 meta_display_get_current_time (MetaDisplay *display); /* utility goo */ const char* meta_event_mode_to_string (int m); const char* meta_event_detail_to_string (int d); void meta_display_queue_retheme_all_windows (MetaDisplay *display); void meta_display_retheme_all (void); void meta_display_ping_window (MetaDisplay *display, MetaWindow *window, Time timestamp, MetaWindowPingFunc ping_reply_func, MetaWindowPingFunc ping_timeout_func, void *user_data); gboolean meta_display_window_has_pending_pings (MetaDisplay *display, MetaWindow *window); #endif