Add support for ContentViewCore helpers on Tab

chrome/android/java/src/org/chromium/chrome/browser/TabObserver.java

 // Copyright 2013 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.
 
 package org.chromium.chrome.browser;
 
 import android.view.ContextMenu;
 
 import org.chromium.content.browser.ContentViewCore;
 import org.chromium.content_public.browser.WebContents;
@@ skipping 29 matching lines @@
      */
     void onDestroyed(Tab tab);
 
     /**
      * Called when the tab content changes (to/from native pages or swapping native WebContents).
      * @param tab The notifying {@link Tab}.
      */
     void onContentChanged(Tab tab);
 
     /**
+     * Called when a {@link ContentViewCore} overlay is attached to {@code tab}.
+     * @param tab     The notifying {@link Tab}.
+     * @param content The {@link ContentViewCore} being added.
+     */
+    void onOverlayContentViewCoreAdded(Tab tab, ContentViewCore content);
+
+    /**
+     * Called when a {@link ContentViewCore} overlay is detached from {@code tab}.
+     * @param tab     The notifying {@link Tab}.
+     * @param content The {@link ContentViewCore} being removed.
+     */
+    void onOverlayContentViewCoreRemoved(Tab tab, ContentViewCore content);
+
+    /**
      * Called when loadUrl is triggered on a a {@link Tab}.
      * @param tab      The notifying {@link Tab}.
      * @param url      The url that is being loaded.
      * @param loadType The type of load that was performed.
      *
      * @see TabLoadStatus#PAGE_LOAD_FAILED
      * @see TabLoadStatus#DEFAULT_PAGE_LOAD
      * @see TabLoadStatus#PARTIAL_PRERENDERED_PAGE_LOAD
      * @see TabLoadStatus#FULL_PRERENDERED_PAGE_LOAD
      */
@@ skipping 193 matching lines @@
      * @param tab The notifying {@link Tab}.
      */
     public void onDidAttachInterstitialPage(Tab tab);
 
     /**
      * Called when an interstitial page gets detached from the tab content.
      * @param tab The notifying {@link Tab}.
      */
     public void onDidDetachInterstitialPage(Tab tab);
 
+    /**
+     * Called when a navigation is started to a pending entry.
+     * @param tab The notifying {@link Tab}.
+     * @param url The url being navigated to.
+     */
     public void onDidStartNavigationToPendingEntry(Tab tab, String url);
 
     /**
      * Called when the background color for the tab has changed.
      * @param tab The notifying {@link Tab}.
      * @param color The current background color.
      */
     public void onBackgroundColorChanged(Tab tab, int color);
 
+    /**
+     * Called when a {@link WebContents} object has been created.
+     * @param tab                 The notifying {@link Tab}.
+     * @param sourceWebContents   The {@link WebContents} that triggered the creation.
+     * @param openerRenderFrameId The opener render frame id.
+     * @param frameName           The name of the frame.
+     * @param targetUrl           The target url.
+     * @param newWebContents      The newly created {@link WebContents}.
+     */
     public void webContentsCreated(Tab tab, WebContents sourceWebContents, long openerRenderFrameId,
             String frameName, String targetUrl, WebContents newWebContents);
 }