Streamline the layout of the BrowserView's children TabContents views....

views/controls/single_split_view.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 VIEWS_CONTROLS_SINGLE_SPLIT_VIEW_H_
 #define VIEWS_CONTROLS_SINGLE_SPLIT_VIEW_H_
 #pragma once
 
 #include "views/view.h"
 
 namespace views {
 
-// SingleSplitView lays out two views horizontally. A splitter exists between
-// the two views that the user can drag around to resize the views.
+// SingleSplitView lays out two views next to each other, either horizontally
+// or vertically. A splitter exists between the two views that the user can
+// drag around to resize the views.
+// When non-NULL observer is provided at the construction time, SingleSplitView
+// expects the entity resizing the SingleSplitView itself to resize its children
+// views (CalculateChildrenBounds and ResizeChildren functions are handy for
+// this). Observer's SplitHandleMoved notification helps to handle user
+// initiated layout changes.
+// When observer is NULL, SingleSplitView resizes children views automatically.
 class SingleSplitView : public views::View {
  public:
   enum Orientation {
     HORIZONTAL_SPLIT,
     VERTICAL_SPLIT
   };
 
-  SingleSplitView(View* leading, View* trailing, Orientation orientation);
+  class Observer {
+   public:
+    // Invoked when split handle is moved by the user.
+    virtual void SplitHandleMoved(SingleSplitView* source) = 0;
+   protected:
+    virtual ~Observer() {}
+  };
+
+  SingleSplitView(View* leading, View* trailing, Orientation orientation,

[sky, 2011/01/07 21:35:40]

each arg on its own line.

[Aleksey Shlyapnikov, 2011/01/07 23:06:00]

Done.

+                  Observer* observer);
 
   virtual void DidChangeBounds(const gfx::Rect& previous,
                                const gfx::Rect& current);
 
   virtual void Layout();
 
   virtual AccessibilityTypes::Role GetAccessibleRole();
 
   // SingleSplitView's preferred size is the sum of the preferred widths
   // and the max of the heights.
   virtual gfx::Size GetPreferredSize();
 
   // Overriden to return a resize cursor when over the divider.
   virtual gfx::NativeCursor GetCursorForPoint(Event::EventType event_type,
                                               const gfx::Point& p);
 
   void set_divider_offset(int divider_offset) {
     divider_offset_ = divider_offset;
   }
-  int divider_offset() { return divider_offset_; }
+  int divider_offset() const { return divider_offset_; }
 
   // Sets whether the leading component is resized when the split views size
   // changes. The default is true. A value of false results in the trailing
   // component resizing on a bounds change.
   void set_resize_leading_on_bounds_change(bool resize) {
     resize_leading_on_bounds_change_ = resize;
   }
 
+  // Calculates ideal leading and trailing view bounds according to the current
+  // split view bounds, divider offset and children visiblity.
+  // Does not change children view bounds.
+  void CalculateChildrenBounds(gfx::Rect* leading_bounds,
+                               gfx::Rect* trailing_bounds) const;
+
+  // Resizes children views to the leading_bounds and trailing_bounds.
+  void ResizeChildren(const gfx::Rect& leading_bounds,
+                      const gfx::Rect& trailing_bounds) const;
+
  protected:
   virtual bool OnMousePressed(const MouseEvent& event);
   virtual bool OnMouseDragged(const MouseEvent& event);
   virtual void OnMouseReleased(const MouseEvent& event, bool canceled);
 
  private:
   // Returns true if |x| or |y| is over the divider.
   bool IsPointInDivider(const gfx::Point& p);
 
+  // Returns divider offset within primary axis size range.
+  int NormalizeDividerOffset(int divider_offset) const;
+
   // Returns width in case of horizontal split and height otherwise.
-  int GetPrimaryAxisSize() {
+  int GetPrimaryAxisSize() const {
     return GetPrimaryAxisSize(width(), height());
   }
 
-  int GetPrimaryAxisSize(int h, int v) {
+  int GetPrimaryAxisSize(int h, int v) const {
     return is_horizontal_ ? h : v;
   }
 
   // Used to track drag info.
   struct DragInfo {
     // The initial coordinate of the mouse when the user started the drag.
     int initial_mouse_offset;
     // The initial position of the divider when the user started the drag.
     int initial_divider_offset;
   };
 
   DragInfo drag_info_;
 
   // Orientation of the split view.
   bool is_horizontal_;
 
   // Position of the divider.
   int divider_offset_;
 
   bool resize_leading_on_bounds_change_;
 
+  // Observer to notify about user initiated handle movements. Not own by us.
+  Observer* observer_;
+
   DISALLOW_COPY_AND_ASSIGN(SingleSplitView);
 };
 
 }  // namespace views
 
 #endif  // VIEWS_CONTROLS_SINGLE_SPLIT_VIEW_H_