Reorder the NativeViews attached to a view via kViewHostKey according to the position of the view

ui/aura/window.cc

 // 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.
 
 #include "ui/aura/window.h"
 
 #include <algorithm>
 
 #include "base/bind.h"
 #include "base/bind_helpers.h"
@@ skipping 145 matching lines @@
   layer_->set_delegate(this);
   layer_->SetMasksToBounds(old_layer->GetMasksToBounds());
   // Move the original texture to the new layer if the old layer has a
   // texture and we could copy it into the old layer,
   // crbug.com/175211.
   if (delegate_ && old_texture)
     layer_->SetExternalTexture(old_texture);
 
   UpdateLayerName(name_);
   layer_->SetFillsBoundsOpaquely(!transparent_);
-  // Install new layer as a sibling of the old layer, stacked on top of it.
+  // Install new layer as a sibling of the old layer, stacked below it.

[sky, 2013/05/28 14:03:50]

Document why it's important to stack below rather than above.

[pkotwicz, 2013/05/28 15:15:00]

This is actually a bad diff, this change is not part of this CL.

   if (old_layer->parent()) {
     old_layer->parent()->Add(layer_);
-    old_layer->parent()->StackAbove(layer_, old_layer);
+    old_layer->parent()->StackBelow(layer_, old_layer);
   }
   // Migrate all the child layers over to the new layer. Copy the list because
   // the items are removed during iteration.
   std::vector<ui::Layer*> children_copy = old_layer->children();
   for (std::vector<ui::Layer*>::const_iterator it = children_copy.begin();
        it != children_copy.end();
        ++it) {
     ui::Layer* child = *it;
     layer_->Add(child);
   }
@@ skipping 153 matching lines @@
 void Window::StackChildAtTop(Window* child) {
   if (children_.size() <= 1 || child == children_.back())
     return;  // In the front already.
   StackChildAbove(child, children_.back());
 }
 
 void Window::StackChildAbove(Window* child, Window* target) {
   StackChildRelativeTo(child, target, STACK_ABOVE);
 }
 
+void Window::StackChildAtBottom(Window* child) {
+  if (children_.size() <= 1 || child == children_.front())
+    return;  // At the bottom already.
+  StackChildBelow(child, children_.front());
+}
+
 void Window::StackChildBelow(Window* child, Window* target) {
   StackChildRelativeTo(child, target, STACK_BELOW);
 }
 
 void Window::AddChild(Window* child) {
   WindowObserver::HierarchyChangeParams params;
   params.target = child;
   params.new_parent = this;
   params.old_parent = child->parent();
   params.phase = WindowObserver::HierarchyChangeParams::HIERARCHY_CHANGING;
@@ skipping 747 matching lines @@
   bool contains_mouse = false;
   if (IsVisible()) {
     RootWindow* root_window = GetRootWindow();
     contains_mouse = root_window &&
         ContainsPointInRoot(root_window->GetLastMouseLocationInRoot());
   }
   return contains_mouse;
 }
 
 }  // namespace aura