aec3edb1cc
Traditionally, WMs unmap windows when minimizing them, and map them when restoring them or wanting to show them for other reasons, like upon creation. However, as metacity morphed into mutter, we optionally chose to keep windows mapped for the lifetime of the window under the user option "live-window-previews", which makes the code keep windows mapped so it can show window preview for minimized windows in other places, like Alt-Tab and Expose. I removed this preference two years ago mechanically, by removing all the if statements, but never went through and cleaned up the code so that windows are simply mapped for the lifetime of the window -- the "architecture" of the old code that maps and unmaps on show/hide was still there. Remove this now. The one case we still need to be careful of is shaded windows, in which we do still unmap the client window. In the future, we might want to show previews of shaded windows in the overview and Alt-Tab. In that we'd also keep shaded windows mapped, and could remove all unmap logic, but we'd need a more complex method of showing the shaded titlebar, such as using a different actor. At the same time, simplify the compositor interface by removing meta_compositor_window_[un]mapped API, and instead adding/removing the window on-demand. https://bugzilla.gnome.org/show_bug.cgi?id=720631
258 lines
12 KiB
C
258 lines
12 KiB
C
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
|
|
|
|
/*
|
|
* Copyright (C) 2008 Iain Holmes
|
|
*
|
|
* 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, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef META_WINDOW_H
|
|
#define META_WINDOW_H
|
|
|
|
#include <glib-object.h>
|
|
#include <cairo.h>
|
|
#include <X11/Xlib.h>
|
|
|
|
#include <meta/boxes.h>
|
|
#include <meta/types.h>
|
|
|
|
/**
|
|
* MetaWindowType:
|
|
* @META_WINDOW_NORMAL: Normal
|
|
* @META_WINDOW_DESKTOP: Desktop
|
|
* @META_WINDOW_DOCK: Dock
|
|
* @META_WINDOW_DIALOG: Dialog
|
|
* @META_WINDOW_MODAL_DIALOG: Modal dialog
|
|
* @META_WINDOW_TOOLBAR: Toolbar
|
|
* @META_WINDOW_MENU: Menu
|
|
* @META_WINDOW_UTILITY: Utility
|
|
* @META_WINDOW_SPLASHSCREEN: Splashcreen
|
|
* @META_WINDOW_DROPDOWN_MENU: Dropdown menu
|
|
* @META_WINDOW_POPUP_MENU: Popup menu
|
|
* @META_WINDOW_TOOLTIP: Tooltip
|
|
* @META_WINDOW_NOTIFICATION: Notification
|
|
* @META_WINDOW_COMBO: Combobox
|
|
* @META_WINDOW_DND: Drag and drop
|
|
* @META_WINDOW_OVERRIDE_OTHER: Other override-redirect window type
|
|
*/
|
|
typedef enum
|
|
{
|
|
META_WINDOW_NORMAL,
|
|
META_WINDOW_DESKTOP,
|
|
META_WINDOW_DOCK,
|
|
META_WINDOW_DIALOG,
|
|
META_WINDOW_MODAL_DIALOG,
|
|
META_WINDOW_TOOLBAR,
|
|
META_WINDOW_MENU,
|
|
META_WINDOW_UTILITY,
|
|
META_WINDOW_SPLASHSCREEN,
|
|
|
|
/* override redirect window types: */
|
|
META_WINDOW_DROPDOWN_MENU,
|
|
META_WINDOW_POPUP_MENU,
|
|
META_WINDOW_TOOLTIP,
|
|
META_WINDOW_NOTIFICATION,
|
|
META_WINDOW_COMBO,
|
|
META_WINDOW_DND,
|
|
META_WINDOW_OVERRIDE_OTHER
|
|
} MetaWindowType;
|
|
|
|
/**
|
|
* MetaMaximizeFlags:
|
|
* @META_MAXIMIZE_HORIZONTAL: Horizontal
|
|
* @META_MAXIMIZE_VERTICAL: Vertical
|
|
*/
|
|
typedef enum
|
|
{
|
|
META_MAXIMIZE_HORIZONTAL = 1 << 0,
|
|
META_MAXIMIZE_VERTICAL = 1 << 1
|
|
} MetaMaximizeFlags;
|
|
|
|
/**
|
|
* MetaWindowClientType:
|
|
* @META_WINDOW_CLIENT_TYPE_WAYLAND: A Wayland based window
|
|
* @META_WINDOW_CLIENT_TYPE_X11: An X11 based window
|
|
*/
|
|
typedef enum {
|
|
META_WINDOW_CLIENT_TYPE_WAYLAND,
|
|
META_WINDOW_CLIENT_TYPE_X11
|
|
} MetaWindowClientType;
|
|
|
|
#define META_TYPE_WINDOW (meta_window_get_type ())
|
|
#define META_WINDOW(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), META_TYPE_WINDOW, MetaWindow))
|
|
#define META_WINDOW_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), META_TYPE_WINDOW, MetaWindowClass))
|
|
#define META_IS_WINDOW(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), META_TYPE_WINDOW))
|
|
#define META_IS_WINDOW_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), META_TYPE_WINDOW))
|
|
#define META_WINDOW_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), META_TYPE_WINDOW, MetaWindowClass))
|
|
|
|
typedef struct _MetaWindowClass MetaWindowClass;
|
|
|
|
GType meta_window_get_type (void);
|
|
|
|
MetaFrame *meta_window_get_frame (MetaWindow *window);
|
|
gboolean meta_window_has_focus (MetaWindow *window);
|
|
gboolean meta_window_appears_focused (MetaWindow *window);
|
|
gboolean meta_window_is_shaded (MetaWindow *window);
|
|
gboolean meta_window_is_override_redirect (MetaWindow *window);
|
|
gboolean meta_window_is_skip_taskbar (MetaWindow *window);
|
|
MetaRectangle *meta_window_get_rect (MetaWindow *window);
|
|
void meta_window_get_input_rect (const MetaWindow *window, MetaRectangle *rect);
|
|
|
|
void meta_window_get_frame_rect (const MetaWindow *window, MetaRectangle *rect);
|
|
void meta_window_get_outer_rect (const MetaWindow *window, MetaRectangle *rect) G_GNUC_DEPRECATED;
|
|
|
|
void meta_window_client_rect_to_frame_rect (MetaWindow *window,
|
|
MetaRectangle *client_rect,
|
|
MetaRectangle *frame_rect);
|
|
void meta_window_frame_rect_to_client_rect (MetaWindow *window,
|
|
MetaRectangle *frame_rect,
|
|
MetaRectangle *client_rect);
|
|
|
|
MetaScreen *meta_window_get_screen (MetaWindow *window);
|
|
MetaDisplay *meta_window_get_display (MetaWindow *window);
|
|
Window meta_window_get_xwindow (MetaWindow *window);
|
|
MetaWindowType meta_window_get_window_type (MetaWindow *window);
|
|
Atom meta_window_get_window_type_atom (MetaWindow *window);
|
|
MetaWorkspace *meta_window_get_workspace (MetaWindow *window);
|
|
int meta_window_get_monitor (MetaWindow *window);
|
|
gboolean meta_window_is_on_all_workspaces (MetaWindow *window);
|
|
gboolean meta_window_located_on_workspace (MetaWindow *window,
|
|
MetaWorkspace *workspace);
|
|
gboolean meta_window_is_hidden (MetaWindow *window);
|
|
void meta_window_activate (MetaWindow *window,guint32 current_time);
|
|
void meta_window_activate_with_workspace (MetaWindow *window,
|
|
guint32 current_time,
|
|
MetaWorkspace *workspace);
|
|
const char * meta_window_get_description (MetaWindow *window);
|
|
const char * meta_window_get_wm_class (MetaWindow *window);
|
|
const char * meta_window_get_wm_class_instance (MetaWindow *window);
|
|
gboolean meta_window_showing_on_its_workspace (MetaWindow *window);
|
|
|
|
const char * meta_window_get_gtk_application_id (MetaWindow *window);
|
|
const char * meta_window_get_gtk_unique_bus_name (MetaWindow *window);
|
|
const char * meta_window_get_gtk_application_object_path (MetaWindow *window);
|
|
const char * meta_window_get_gtk_window_object_path (MetaWindow *window);
|
|
const char * meta_window_get_gtk_app_menu_object_path (MetaWindow *window);
|
|
const char * meta_window_get_gtk_menubar_object_path (MetaWindow *window);
|
|
|
|
void meta_window_move(MetaWindow *window, gboolean user_op, int root_x_nw, int root_y_nw);
|
|
void meta_window_move_frame(MetaWindow *window, gboolean user_op, int root_x_nw, int root_y_nw);
|
|
void meta_window_move_resize_frame (MetaWindow *window, gboolean user_op, int root_x_nw, int root_y_nw, int w, int h);
|
|
void meta_window_move_to_monitor (MetaWindow *window, int monitor);
|
|
void meta_window_resize(MetaWindow *window, gboolean user_op, int w, int h);
|
|
|
|
void meta_window_set_demands_attention (MetaWindow *window);
|
|
void meta_window_unset_demands_attention (MetaWindow *window);
|
|
|
|
const char* meta_window_get_startup_id (MetaWindow *window);
|
|
void meta_window_change_workspace_by_index (MetaWindow *window,
|
|
gint space_index,
|
|
gboolean append);
|
|
void meta_window_change_workspace (MetaWindow *window,
|
|
MetaWorkspace *workspace);
|
|
GObject *meta_window_get_compositor_private (MetaWindow *window);
|
|
void meta_window_set_compositor_private (MetaWindow *window, GObject *priv);
|
|
void meta_window_configure_notify (MetaWindow *window, XConfigureEvent *event);
|
|
const char *meta_window_get_role (MetaWindow *window);
|
|
MetaStackLayer meta_window_get_layer (MetaWindow *window);
|
|
MetaWindow* meta_window_find_root_ancestor (MetaWindow *window);
|
|
gboolean meta_window_is_ancestor_of_transient (MetaWindow *window,
|
|
MetaWindow *transient);
|
|
|
|
typedef gboolean (*MetaWindowForeachFunc) (MetaWindow *window,
|
|
void *user_data);
|
|
|
|
void meta_window_foreach_transient (MetaWindow *window,
|
|
MetaWindowForeachFunc func,
|
|
void *user_data);
|
|
void meta_window_foreach_ancestor (MetaWindow *window,
|
|
MetaWindowForeachFunc func,
|
|
void *user_data);
|
|
|
|
MetaMaximizeFlags meta_window_get_maximized (MetaWindow *window);
|
|
gboolean meta_window_is_fullscreen (MetaWindow *window);
|
|
gboolean meta_window_is_screen_sized (MetaWindow *window);
|
|
gboolean meta_window_is_monitor_sized (MetaWindow *window);
|
|
gboolean meta_window_is_on_primary_monitor (MetaWindow *window);
|
|
gboolean meta_window_requested_bypass_compositor (MetaWindow *window);
|
|
gboolean meta_window_requested_dont_bypass_compositor (MetaWindow *window);
|
|
gint *meta_window_get_all_monitors (MetaWindow *window, gsize *length);
|
|
|
|
gboolean meta_window_get_icon_geometry (MetaWindow *window,
|
|
MetaRectangle *rect);
|
|
void meta_window_set_icon_geometry (MetaWindow *window,
|
|
MetaRectangle *rect);
|
|
void meta_window_maximize (MetaWindow *window,
|
|
MetaMaximizeFlags directions);
|
|
void meta_window_unmaximize (MetaWindow *window,
|
|
MetaMaximizeFlags directions);
|
|
void meta_window_minimize (MetaWindow *window);
|
|
void meta_window_unminimize (MetaWindow *window);
|
|
void meta_window_raise (MetaWindow *window);
|
|
void meta_window_lower (MetaWindow *window);
|
|
const char *meta_window_get_title (MetaWindow *window);
|
|
MetaWindow *meta_window_get_transient_for (MetaWindow *window);
|
|
Window meta_window_get_transient_for_as_xid (MetaWindow *window);
|
|
void meta_window_delete (MetaWindow *window,
|
|
guint32 timestamp);
|
|
guint meta_window_get_stable_sequence (MetaWindow *window);
|
|
guint32 meta_window_get_user_time (MetaWindow *window);
|
|
int meta_window_get_pid (MetaWindow *window);
|
|
const char *meta_window_get_client_machine (MetaWindow *window);
|
|
gboolean meta_window_is_remote (MetaWindow *window);
|
|
gboolean meta_window_is_modal (MetaWindow *window);
|
|
gboolean meta_window_is_attached_dialog (MetaWindow *window);
|
|
const char *meta_window_get_mutter_hints (MetaWindow *window);
|
|
|
|
MetaFrameType meta_window_get_frame_type (MetaWindow *window);
|
|
|
|
cairo_region_t *meta_window_get_frame_bounds (MetaWindow *window);
|
|
|
|
MetaWindow *meta_window_get_tile_match (MetaWindow *window);
|
|
|
|
void meta_window_make_fullscreen (MetaWindow *window);
|
|
void meta_window_unmake_fullscreen (MetaWindow *window);
|
|
void meta_window_make_above (MetaWindow *window);
|
|
void meta_window_unmake_above (MetaWindow *window);
|
|
void meta_window_shade (MetaWindow *window,
|
|
guint32 timestamp);
|
|
void meta_window_unshade (MetaWindow *window,
|
|
guint32 timestamp);
|
|
void meta_window_stick (MetaWindow *window);
|
|
void meta_window_unstick (MetaWindow *window);
|
|
|
|
void meta_window_kill (MetaWindow *window);
|
|
void meta_window_focus (MetaWindow *window,
|
|
guint32 timestamp);
|
|
|
|
void meta_window_check_alive (MetaWindow *window,
|
|
guint32 timestamp);
|
|
|
|
void meta_window_get_work_area_current_monitor (MetaWindow *window,
|
|
MetaRectangle *area);
|
|
void meta_window_get_work_area_for_monitor (MetaWindow *window,
|
|
int which_monitor,
|
|
MetaRectangle *area);
|
|
void meta_window_get_work_area_all_monitors (MetaWindow *window,
|
|
MetaRectangle *area);
|
|
|
|
void meta_window_begin_grab_op (MetaWindow *window,
|
|
MetaGrabOp op,
|
|
gboolean frame_action,
|
|
guint32 timestamp);
|
|
|
|
gboolean meta_window_can_close (MetaWindow *window);
|
|
|
|
#endif
|