[mac] Implement dragging of multiple tabs.

chrome/browser/ui/cocoa/tabs/tab_strip_controller.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_COCOA_TABS_TAB_STRIP_CONTROLLER_H_
 #define CHROME_BROWSER_UI_COCOA_TABS_TAB_STRIP_CONTROLLER_H_
 
 #import <Cocoa/Cocoa.h>
 
 #include "base/mac/scoped_nsobject.h"
@@ skipping 141 matching lines @@
 // |delegate| is the one listening to filtered TabStripModelObserverBridge's
 // events (see TabStripControllerDelegate for more details).
 - (id)initWithView:(TabStripView*)view
         switchView:(NSView*)switchView
            browser:(Browser*)browser
           delegate:(id<TabStripControllerDelegate>)delegate;
 
 // Returns the model behind this controller.
 - (TabStripModel*)tabStripModel;
 
+// Returns all tab views.
+- (NSArray*)tabViews;
+
 // Return the view for the currently active tab.
 - (NSView*)activeTabView;
 
-// Set the frame of the active tab, also updates the internal frame dict.
-- (void)setFrameOfActiveTab:(NSRect)frame;
+// Set the frame of |tabView|, also updates the internal frame dict.
+- (void)setFrame:(NSRect)frame ofTabView:(NSView*)tabView;
 
 // Move the given tab at index |from| in this window to the location of the
 // current placeholder.
 - (void)moveTabFromIndex:(NSInteger)from;
 
-// Drop a given WebContents at the location of the current placeholder.
-// If there is no placeholder, it will go at the end. Used when dragging from
+// Drop a given WebContents at |modelIndex|. Used when dragging from
 // another window when we don't have access to the WebContents as part of our
 // strip. |frame| is in the coordinate system of the tab strip view and
 // represents where the user dropped the new tab so it can be animated into its
 // correct location when the tab is added to the model. If the tab was pinned in
 // its previous window, setting |pinned| to YES will propagate that state to the
 // new window. Mini-tabs are either app or pinned tabs; the app state is stored
 // by the |contents|, but the |pinned| state is the caller's responsibility.

[Robert Sesek, 2014/02/24 15:25:20]

Should also discuss what |activate| does.

[Andre, 2014/02/25 01:16:16]

Done.

 - (void)dropWebContents:(content::WebContents*)contents
+                atIndex:(int)modelIndex
               withFrame:(NSRect)frame
-            asPinnedTab:(BOOL)pinned;
+            asPinnedTab:(BOOL)pinned
+               activate:(BOOL)activate;
 
 // Returns the index of the subview |view|. Returns -1 if not present. Takes
 // closing tabs into account such that this index will correctly match the tab
 // model. If |view| is in the process of closing, returns -1, as closing tabs
 // are no longer in the model.
 - (NSInteger)modelIndexForTabView:(NSView*)view;
 
+- (NSArray*)selectedViews;

[Robert Sesek, 2014/02/24 15:25:20]

Comment all public declarations.

[Andre, 2014/02/25 01:16:16]

Done.

+
 // Return the view at a given index.
 - (NSView*)viewAtIndex:(NSUInteger)index;
 
 // Return the number of tab views in the tab strip. It's same as number of tabs
 // in the model, except when a tab is closing, which will be counted in views
 // count, but no longer in the model.
 - (NSUInteger)viewsCount;
 
 // Set the placeholder for a dragged tab, allowing the |frame| to be specified.
 // This causes this tab to be rendered in an arbitrary position.
 - (void)insertPlaceholderForTab:(TabView*)tab frame:(NSRect)frame;
 
+// Find the model index based on the x coordinate of the placeholder. If there
+// is no placeholder, this returns the end of the tab strip. Closing tabs are
+// not considered in computing the index.
+- (int)indexOfPlaceholder;
+
 // Returns whether a tab is being dragged within the tab strip.
 - (BOOL)isDragSessionActive;
 
 // Returns whether or not |tab| can still be fully seen in the tab strip or if
 // its current position would cause it be obscured by things such as the edge
 // of the window or the window decorations. Returns YES only if the entire tab
 // is visible.
 - (BOOL)isTabFullyVisible:(TabView*)tab;
 
 // Show or hide the new tab button. The button is hidden immediately, but
@@ skipping 26 matching lines @@
 
 @interface TabStripController(TestingAPI)
 - (void)setTabTitle:(TabController*)tab
        withContents:(content::WebContents*)contents;
 @end
 
 // Returns the parent view to use when showing a sheet for a given web contents.
 NSView* GetSheetParentViewForWebContents(content::WebContents* web_contents);
 
 #endif  // CHROME_BROWSER_UI_COCOA_TABS_TAB_STRIP_CONTROLLER_H_