Immersive mode reveals the tabstrip/omnibox on top of web content

chrome/browser/ui/views/frame/browser_view.h

 // Copyright (c) 2012 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_UI_VIEWS_FRAME_BROWSER_VIEW_H_
 #define CHROME_BROWSER_UI_VIEWS_FRAME_BROWSER_VIEW_H_
 
 #include <map>
 #include <string>
 #include <vector>
@@ skipping 81 matching lines @@
                     public ui::AcceleratorProvider,
                     public views::WidgetDelegate,
                     public views::WidgetObserver,
                     public views::ClientView,
                     public InfoBarContainer::Delegate,
                     public views::SingleSplitViewListener,
                     public gfx::SysColorChangeListener {
  public:
   // The browser view's class name.
   static const char kViewClassName[];
+  // Initial child indices for well-known views.
+  static const int kTabstripIndex;
+  static const int kInfoBarIndex;
+  static const int kToolbarIndex;
 
   explicit BrowserView(Browser* browser);
   virtual ~BrowserView();
 
   void set_frame(BrowserFrame* frame) { frame_ = frame; }
   BrowserFrame* frame() const { return frame_; }
 
 #if defined(OS_WIN) || defined(USE_AURA)
   // Returns a pointer to the BrowserView* interface implementation (an
   // instance of this object, typically) for a given native window, or NULL if
@@ skipping 458 matching lines @@
   int last_focused_view_storage_id_;
 
   // The BrowserFrame that hosts this view.
   BrowserFrame* frame_;
 
   // The Browser object we are associated with.
   scoped_ptr<Browser> browser_;
 
   // BrowserView layout (LTR one is pictured here).
   //
-  // ----------------------------------------------------------------
-  // | Tabs (1)                                                     |
-  // |--------------------------------------------------------------|
-  // | Navigation buttons, menus and the address bar (toolbar_)     |
-  // |--------------------------------------------------------------|
-  // | All infobars (infobar_container_) *                          |
-  // |--------------------------------------------------------------|
-  // | Bookmarks (bookmark_bar_view_) *                             |
-  // |--------------------------------------------------------------|
-  // |Page content (contents_)                                     ||
-  // |-------------------------------------------------------------||
-  // || contents_container_ and/or                                |||
-  // || preview_controller_->preview_container_                   |||
-  // ||                                                           |||
-  // ||                                                           |||
-  // ||                                                           |||
-  // ||                                                           |||
-  // ||                                                           |||
-  // |-------------------------------------------------------------||
-  // |==(2)=========================================================|
-  // |                                                              |
-  // |                                                              |
-  // | Debugger (devtools_container_)                               |
-  // |                                                              |
-  // |                                                              |
-  // |--------------------------------------------------------------|
-  // | Active downloads (download_shelf_)                           |
-  // ----------------------------------------------------------------
-  //
-  // (1) - tabstrip_, default position
-  // (2) - contents_split_
+  // --------------------------------------------------------------------
+  // | Tabs (tabstrip_)                                                 |
+  // |------------------------------------------------------------------|
+  // | Navigation buttons, menus and the address bar (toolbar_)         |
+  // |------------------------------------------------------------------|
+  // | All infobars (infobar_container_) *                              |
+  // |------------------------------------------------------------------|
+  // | Bookmarks (bookmark_bar_view_) *                                 |
+  // |------------------------------------------------------------------|
+  // | Debugger splitter (contents_split_)                              |
+  // |  +------------------------------------------------------------+  |
+  // |  | Page content (contents_)                                   |  |
+  // |  |  +------------------------------------------------------+  |  |
+  // |  |  | contents_container_ and/or                           |  |  |
+  // |  |  | preview_controller_->preview_container_              |  |  |
+  // |  |  |                                                      |  |  |
+  // |  |  |                                                      |  |  |
+  // |  |  +------------------------------------------------------+  |  |
+  // |  +------------------------------------------------------------+  |
+  // |  +------------------------------------------------------------+  |
+  // |  | Debugger (devtools_container_)                             |  |
+  // |  |                                                            |  |
+  // |  +------------------------------------------------------------+  |
+  // |------------------------------------------------------------------|
+  // | Active downloads (download_shelf_)                               |
+  // --------------------------------------------------------------------
   //

[sky, 2012/11/29 19:30:23]

Can you also add a comment about reveal mode.

[James Cook, 2012/11/29 21:20:59]

Done.

   // * - The bookmark bar and info bar are swapped when on the new tab page.
   //     Additionally contents_ is positioned on top of the bookmark bar when
   //     the bookmark bar is detached. This is done to allow the
   //     preview_controller_->preview_container_ to appear over the bookmark
   //     bar.
 
   // Tool/Info bars that we are currently showing. Used for layout.
   // active_bookmark_bar_ is either NULL, if the bookmark bar isn't showing,
   // or is bookmark_bar_view_ if the bookmark bar is showing.
   views::View* active_bookmark_bar_;
@@ skipping 99 matching lines @@
   gfx::ScopedSysColorChangeListener color_change_listener_;
 
   scoped_ptr<InstantPreviewControllerViews> preview_controller_;
 
   mutable base::WeakPtrFactory<BrowserView> activate_modal_dialog_factory_;
 
   DISALLOW_COPY_AND_ASSIGN(BrowserView);
 };
 
 #endif  // CHROME_BROWSER_UI_VIEWS_FRAME_BROWSER_VIEW_H_