This adds in the ability for Chrome to generate windows with snapshots of all...

chrome/browser/chromeos/wm_ipc.h

 // Copyright (c) 2010 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_BROWSER_CHROMEOS_WM_IPC_H_
 #define CHROME_BROWSER_CHROMEOS_WM_IPC_H_
 
 #include <gtk/gtk.h>
 #include <map>
 #include <string>
@@ skipping 23 matching lines @@
     ATOM_WM_STATE,
     ATOM_WM_TRANSIENT_FOR,
     ATOM_WM_SYSTEM_METRICS,
     kNumAtoms,
   };
 
   enum WindowType {
     WINDOW_TYPE_UNKNOWN = 0,
 
     // A top-level Chrome window.
+    //   param[0]: The number of tabs currently in this Chrome window.
+    //   param[1]: The index of the currently selected tab in this
+    //             Chrome window.
     WINDOW_TYPE_CHROME_TOPLEVEL,
 
-    // A window showing scaled-down views of all of the tabs within a
-    // Chrome window.
-    WINDOW_TYPE_CHROME_TAB_SUMMARY,
-
-    // A tab that's been detached from a Chrome window and is currently
-    // being dragged.
-    //   param[0]: Cursor's initial X position at the start of the drag
-    //   param[1]: Cursor's initial Y position
-    //   param[2]: X component of cursor's offset from upper-left corner of
-    //             tab at start of drag
-    //   param[3]: Y component of cursor's offset
-    WINDOW_TYPE_CHROME_FLOATING_TAB,
+    // Vestiges of the old windows-across-the-bottom overview mode.
+    DEPRECATED_WINDOW_TYPE_CHROME_TAB_SUMMARY,
+    DEPRECATED_WINDOW_TYPE_CHROME_FLOATING_TAB,
 
     // The contents of a popup window.
     //   param[0]: X ID of associated titlebar, which must be mapped before
     //             its content
     //   param[1]: Initial state for panel (0 is collapsed, 1 is expanded)
     WINDOW_TYPE_CHROME_PANEL_CONTENT,
 
     // A small window representing a collapsed panel in the panel bar and
     // drawn above the panel when it's expanded.
     WINDOW_TYPE_CHROME_PANEL_TITLEBAR,
 
-    // A small window that when clicked creates a new browser window.
-    WINDOW_TYPE_CREATE_BROWSER_WINDOW,
+    // Vestiges of an earlier UI design.
+    DEPRECATED_WINDOW_TYPE_CREATE_BROWSER_WINDOW,
 
     // A Chrome info bubble (e.g. the bookmark bubble).  These are
     // transient RGBA windows; we skip the usual transient behavior of
     // centering them over their owner and omit drawing a drop shadow.
     WINDOW_TYPE_CHROME_INFO_BUBBLE,
 
     // A window showing a view of a tab within a Chrome window.
     //   param[0]: X ID of toplevel window that owns it.
-    //   param[1]: index of this tab in the tab order (range is 0 to
-    //             sum of all tabs in all browsers).
+    //   param[1]: index of this tab in the toplevel window that owns it.
     WINDOW_TYPE_CHROME_TAB_SNAPSHOT,
 
     // The following types are used for the windows that represent a user that
     // has already logged into the system.
     //
     // Visually the BORDER contains the IMAGE and CONTROLS windows, the LABEL
     // and UNSELECTED_LABEL are placed beneath the BORDER. The LABEL window is
     // onscreen when the user is selected, otherwise the UNSELECTED_LABEL is
     // on screen. The GUEST window is used when the user clicks on the entry
     // that represents the 'guest' user.
@@ skipping 20 matching lines @@
     kNumWindowTypes,
   };
 
   struct Message {
    public:
     // NOTE: Don't remove values from this enum; it is shared between
     // Chrome and the window manager.
     enum Type {
       UNKNOWN = 0,
 
-      // Notify Chrome when a floating tab has entered or left a tab
-      // summary window.  Sent to the summary window.
-      //   param[0]: X ID of the floating tab window
-      //   param[1]: state (0 means left, 1 means entered or currently in)
-      //   param[2]: X coordinate relative to summary window
-      //   param[3]: Y coordinate
-      CHROME_NOTIFY_FLOATING_TAB_OVER_TAB_SUMMARY,
-
-      // Notify Chrome when a floating tab has entered or left a top-level
-      // window.  Sent to the window being entered/left.
-      //   param[0]: X ID of the floating tab window
-      //   param[1]: state (0 means left, 1 means entered)
-      CHROME_NOTIFY_FLOATING_TAB_OVER_TOPLEVEL,
-
-      // Instruct a top-level Chrome window to change the visibility of its
-      // tab summary window.
-      //   param[0]: desired visibility (0 means hide, 1 means show)
-      //   param[1]: X position (relative to the left edge of the root
-      //             window) of the center of the top-level window.  Only
-      //             relevant for "show" messages
-      CHROME_SET_TAB_SUMMARY_VISIBILITY,
+      // Vestiges of the old windows-across-the-bottom overview mode.
+      DEPRECATED_CHROME_NOTIFY_FLOATING_TAB_OVER_TAB_SUMMARY,
+      DEPRECATED_CHROME_NOTIFY_FLOATING_TAB_OVER_TOPLEVEL,
+      DEPRECATED_CHROME_SET_TAB_SUMMARY_VISIBILITY,
 
       // Tell the WM to collapse or expand a panel.
       //   param[0]: X ID of the panel window
       //   param[1]: desired state (0 means collapsed, 1 means expanded)
       WM_SET_PANEL_STATE,
 
       // Notify Chrome that the panel state has changed.  Sent to the panel
       // window.
       //   param[0]: new state (0 means collapsed, 1 means expanded)
+      // TODO: Deprecate this; Chrome can just watch for changes to the
+      // _CHROME_STATE property to get the same information.
       CHROME_NOTIFY_PANEL_STATE,
 
-      // Instruct the WM to move a floating tab.  The passed-in position is
-      // that of the cursor; the tab's composited window is displaced based
-      // on the cursor's offset from the upper-left corner of the tab at
-      // the start of the drag.
-      //   param[0]: X ID of the floating tab window
-      //   param[1]: X coordinate to which the tab should be moved
-      //   param[2]: Y coordinate
-      WM_MOVE_FLOATING_TAB,
+      // From the old windows-across-the-bottom overview mode.
+      DEPRECATED_WM_MOVE_FLOATING_TAB,
 
       // Notify the WM that a panel has been dragged.
       //   param[0]: X ID of the panel's content window
       //   param[1]: X coordinate to which the upper-right corner of the
       //             panel's titlebar window was dragged
       //   param[2]: Y coordinate to which the upper-right corner of the
       //             panel's titlebar window was dragged
       // Note: The point given is actually that of one pixel to the right
       // of the upper-right corner of the titlebar window.  For example, a
       // no-op move message for a 10-pixel wide titlebar whose upper-left
       // point is at (0, 0) would contain the X and Y paremeters (10, 0):
       // in other words, the position of the titlebar's upper-left point
       // plus its width.  This is intended to make both the Chrome and WM
       // side of things simpler and to avoid some easy-to-make off-by-one
       // errors.
       WM_NOTIFY_PANEL_DRAGGED,
 
       // Notify the WM that the panel drag is complete (that is, the mouse
       // button has been released).
       //   param[0]: X ID of the panel's content window
       WM_NOTIFY_PANEL_DRAG_COMPLETE,
 
-      // Deprecated.  Send a _NET_ACTIVE_WINDOW client message to focus a window
-      // instead (e.g. using gtk_window_present()).
+      // Deprecated.  Send a _NET_ACTIVE_WINDOW client message to focus a
+      // window instead (e.g. using gtk_window_present()).
       DEPRECATED_WM_FOCUS_WINDOW,
 
       // Notify Chrome that the layout mode (for example, overview or
-      // focused) has changed.
-      //   param[0]: new mode (0 means focused, 1 means overview)
+      // active) has changed.  Since overview mode can be "cancelled"
+      // (user hits escape to revert), we have an extra parameter to
+      // indicate this.
+      //   param[0]: new mode (0 means active mode, 1 means overview mode)
+      //   param[1]: was mode cancelled? (0 = no, 1 = yes)
       CHROME_NOTIFY_LAYOUT_MODE,
 
-      // Instruct the WM to enter overview mode.
+      // Deprecated. Instruct the WM to enter overview mode.
       //   param[0]: X ID of the window to show the tab overview for.
-      WM_SWITCH_TO_OVERVIEW_MODE,
+      DEPRECATED_WM_SWITCH_TO_OVERVIEW_MODE,
 
       // Let the WM know which version of this file Chrome is using.  It's
       // difficult to make changes synchronously to Chrome and the WM (our
       // build scripts can use a locally-built Chromium, the latest one
       // from the buildbot, or an older hardcoded version), so it's useful
       // to be able to maintain compatibility in the WM with versions of
       // Chrome that exhibit older behavior.
       //
       // Chrome should send a message to the WM at startup containing the
       // latest version from the list below.  For backwards compatibility,
       // the WM assumes version 0 if it doesn't receive a message.  Here
       // are the changes that have been made in successive versions of the
       // protocol:
       //
       // 1: WM_NOTIFY_PANEL_DRAGGED contains the position of the
       //    upper-right, rather than upper-left, corner of of the titlebar
       //    window
       //
       // TODO: The latest version should be hardcoded in this file once the
       // file is being shared between Chrome and the WM so Chrome can just
       // pull it from there.  Better yet, the message could be sent
       // automatically in WmIpc's c'tor.
       //
       //   param[0]: version of this protocol currently supported
       WM_NOTIFY_IPC_VERSION,
 
-      // Notify Chrome when a tab snapshot has been 'magnified' in the
-      // overview.  Sent to the top level window.
-      //   param[0]: X ID of the tab snapshot window
-      //   param[1]: state (0 means end magnify, 1 means begin magnify)
-      CHROME_NOTIFY_TAB_SNAPSHOT_MAGNIFY,
+      // Notify Chrome when a tab has been selected in the overview.
+      // Sent to the toplevel window associated with the magnified
+      // tab.
+      //   param[0]: tab index of newly selected tab.
+      CHROME_NOTIFY_TAB_SELECT,
 
       // Forces the window manager to hide the login windows.
       WM_HIDE_LOGIN,
 
       // Sets whether login is enabled. If true the user can click on any of the
       // login windows to select one, if false clicks on unselected windows are
       // ignored. This is used when the user attempts a login to make sure the
       // user doesn't select another user.
       //
       //   param[0]: true to enable, false to disable.
@@ skipping 52 matching lines @@
   static WmIpc* instance();
 
   // Get or set a property describing a window's type. Type-specific
   // parameters may also be supplied. The caller is responsible for trapping
   // errors from the X server.
   // TODO: Trap these ourselves.
   bool SetWindowType(GtkWidget* widget,
                      WindowType type,
                      const std::vector<int>* params);
 
-  // Gets the type of the window. The caller is responsible for trapping
-  // errors from the X server.
-  WmIpc::WindowType GetWindowType(GtkWidget* widget);
+  // Gets the type of the window, and any associated parameters. The
+  // caller is responsible for trapping errors from the X server.  If
+  // the parameters are not interesting to the caller, NULL may be
+  // passed for |params|.
+  WmIpc::WindowType GetWindowType(GtkWidget* widget, std::vector<int>* params);
 
   // Sends a message to the WM.
   void SendMessage(const Message& msg);
 
   // If |event| is a valid Message it is decoded into |msg| and true is
   // returned. If false is returned, |event| is not a valid Message.
   bool DecodeMessage(const GdkEventClient& event, Message* msg);
 
   // If |event| is a valid StringMessage it is decoded into |msg| and true is
   // returned. If false is returned, |event| is not a valid StringMessage.
@@ skipping 27 matching lines @@
 
   // Handle to the wm. Used for sending messages.
   XID wm_;
 
   DISALLOW_COPY_AND_ASSIGN(WmIpc);
 };
 
 }  // namespace chromeos
 
 #endif  // CHROME_BROWSER_CHROMEOS_WM_IPC_H_