Embed Flash Fullscreen widget within browser window.

content/public/browser/web_contents_delegate.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 CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_DELEGATE_H_
 #define CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_DELEGATE_H_
 
 #include <set>
 #include <string>
 
@@ skipping 330 matching lines @@
   virtual void RunFileChooser(WebContents* web_contents,
                               const FileChooserParams& params) {}
 
   // Request to enumerate a directory.  This is equivalent to running the file
   // chooser in directory-enumeration mode and having the user select the given
   // directory.
   virtual void EnumerateDirectory(WebContents* web_contents,
                                   int request_id,
                                   const base::FilePath& path) {}
 
+  // Returns true if the delegate will embed a WebContents-owned fullscreen
+  // render widget.  In this case, ToggleFullscreenModeForTab() is used to enter

[jam, 2013/09/11 02:48:26]

nit: don't mention what chrome code does in src/content, as that's a (comment)
layering violation

[miu, 2013/09/11 03:57:03]

Done.

+  // fullscreen mode and the browser view will access the widget by calling
+  // WebContents::GetFullscreenRenderWidgetHostView().  If false is returned,
+  // WebContents will be responsible for showing the fullscreen widget.
+  virtual bool EmbedsFullscreenWidget() const;
+
   // Called when the renderer puts a tab into or out of fullscreen mode.
   virtual void ToggleFullscreenModeForTab(WebContents* web_contents,
                                           bool enter_fullscreen) {}
   virtual bool IsFullscreenForTabOrPending(
       const WebContents* web_contents) const;
 
   // Called when the renderer has scrolled programmatically.
   virtual void DidProgrammaticallyScroll(WebContents* web_contents,
                                          const gfx::Vector2d& scroll_point) {}
 
@@ skipping 91 matching lines @@
   // Called when |this| is no longer the WebContentsDelegate for |source|.
   void Detach(WebContents* source);
 
   // The WebContents that this is currently a delegate for.
   std::set<WebContents*> attached_contents_;
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_DELEGATE_H_