Mac: Make devtools window dockable.

chrome/browser/cocoa/tab_strip_controller.h

 // Copyright (c) 2009 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_COCOA_TAB_STRIP_CONTROLLER_H_
 #define CHROME_BROWSER_COCOA_TAB_STRIP_CONTROLLER_H_
 
 #import <Cocoa/Cocoa.h>
 
 #include <deque>
 #include <map>
 
 #include "base/scoped_nsobject.h"
 #include "base/scoped_ptr.h"
 #import "chrome/browser/cocoa/tab_controller_target.h"
 #import "chrome/browser/cocoa/url_drop_target.h"
 #import "third_party/GTM/AppKit/GTMWindowSheetController.h"
 
+@class TabContentsController;
 @class TabView;
 @class TabStripView;
 
 class Browser;
 class ConstrainedWindowMac;
 class TabStripModelObserverBridge;
 class TabStripModel;
 class TabContents;
 class ToolbarModel;
 
 // A class that handles managing the tab strip in a browser window. It uses
 // a supporting C++ bridge object to register for notifications from the
 // TabStripModel. The Obj-C part of this class handles drag and drop and all
 // the other Cocoa-y aspects.
 //
 // When a new tab is created, we create a TabController which manages loading
 // the contents, including toolbar, from a separate nib file. This controller
 // then handles replacing the contentView of the window. As tabs are switched,
 // the single child of the contentView is swapped around to hold the contents
 // (toolbar and all) representing that tab.
-
 @interface TabStripController :
   NSObject<TabControllerTarget,
            URLDropTargetController,
            GTMWindowSheetControllerDelegate> {
  @private
   TabContents* currentTab_;   // weak, tab for which we're showing state
   scoped_nsobject<TabStripView> tabStripView_;
   NSView* switchView_;  // weak
   scoped_nsobject<NSView> dragBlockingView_;  // avoid bad window server drags
   NSButton* newTabButton_;  // weak, obtained from the nib.
 
   // Tracks the newTabButton_ for rollovers.
   scoped_nsobject<NSTrackingArea> newTabTrackingArea_;
   scoped_ptr<TabStripModelObserverBridge> bridge_;
   Browser* browser_;  // weak
   TabStripModel* tabStripModel_;  // weak
+  
   // Access to the TabContentsControllers (which own the parent view
-  // for the toolbar and associated tab contents) given an index. This needs
-  // to be kept in the same order as the tab strip's model as we will be
-  // using its index from the TabStripModelObserver calls.
+  // for the toolbar and associated tab contents) given an index. Call
+  // |indexFromModelIndex:| to convert a |tabStripModel_| index to a
+  // |tabContentsArray_| index. Do NOT assume that the indices of
+  // |tabStripModel_| and this array are identical, this is e.g. not true while
+  // tabs are animating closed (closed tabs are removed from |tabStripModel_|
+  // immediately, but from |tabContentsArray_| only after their close animation
+  // has completed).
   scoped_nsobject<NSMutableArray> tabContentsArray_;
-  // An array of TabControllers which manage the actual tab views. As above,
-  // this is kept in the same order as the tab strip model.
+  // An array of TabControllers which manage the actual tab views. See note
+  // above |tabContentsArray_|. |tabContentsArray_| and |tabArray_| always
+  // contain objects belonging to the same tabs at the same indices.
   scoped_nsobject<NSMutableArray> tabArray_;
 
   // Set of TabControllers that are currently animating closed.
   scoped_nsobject<NSMutableSet> closingControllers_;
 
   // These values are only used during a drag, and override tab positioning.
   TabView* placeholderTab_;  // weak. Tab being dragged
   NSRect placeholderFrame_;  // Frame to use
   CGFloat placeholderStretchiness_; // Vertical force shown by streching tab.
   NSRect droppedTabFrame_;  // Initial frame of a dropped tab, for animation.
@@ skipping 103 matching lines @@
 // For example, this returns NO if there are any pending tab close animtations.
 - (BOOL)tabDraggingAllowed;
 
 // Default height for tabs.
 + (CGFloat)defaultTabHeight;
 
 // Returns the (lazily created) window sheet controller of this window. Used
 // for the per-tab sheets.
 - (GTMWindowSheetController*)sheetController;
 
+// Returns the currently active TabContentsController.
+- (TabContentsController*)activeTabContentsController;
+
 // See comments in browser_window_controller.h for documentation about these
 // functions.
 - (BOOL)attachConstrainedWindow:(ConstrainedWindowMac*)window;
 - (void)removeConstrainedWindow:(ConstrainedWindowMac*)window;
+- (void)updateDevToolsForContents:(TabContents*)contents;
 
 @end
 
 // Notification sent when the number of tabs changes. The object will be this
 // controller.
 extern NSString* const kTabStripNumberOfTabsChanged;
 
 #endif  // CHROME_BROWSER_COCOA_TAB_STRIP_CONTROLLER_H_