TabContents -> WebContentsImpl, part 16

content/public/browser/web_contents.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_H_
 #define CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_H_
 #pragma once
 
 #include "base/basictypes.h"
 #include "base/callback_forward.h"
@@ skipping 32 matching lines @@
 class RenderWidgetHostView;
 class SessionStorageNamespace;
 class SiteInstance;
 class WebContentsDelegate;
 class WebContentsView;
 struct RendererPreferences;
 
 // Describes what goes in the main content area of a tab.
 class WebContents : public PageNavigator {
  public:
-  // |base_tab_contents| is used if we want to size the new tab contents view
-  // based on an existing tab contents view.  This can be NULL if not needed.
+  // |base_tab_contents| is used if we want to size the new WebContents's view
+  // based on the view of an existing WebContents.  This can be NULL if not
+  // needed.
   //
   // The session storage namespace parameter allows multiple render views and
-  // tab contentses to share the same session storage (part of the WebStorage
+  // web contentses to share the same session storage (part of the WebStorage
   // spec) space. This is useful when restoring tabs, but most callers should
   // pass in NULL which will cause a new SessionStorageNamespace to be created.
   CONTENT_EXPORT static WebContents* Create(
       BrowserContext* browser_context,
       SiteInstance* site_instance,
       int routing_id,
       const WebContents* base_web_contents,
       SessionStorageNamespace* session_storage_namespace);
 
   virtual ~WebContents() {}
 
   // Intrinsic tab state -------------------------------------------------------
 
-  // Returns the property bag for this tab contents, where callers can add
+  // Returns the property bag for this WebContents, where callers can add
   // extra data they may wish to associate with the tab. Returns a pointer
   // rather than a reference since the PropertyAccessors expect this.
   virtual const base::PropertyBag* GetPropertyBag() const = 0;
   virtual base::PropertyBag* GetPropertyBag() = 0;
 
   // Gets/Sets the delegate.
   virtual WebContentsDelegate* GetDelegate() = 0;
   virtual void SetDelegate(WebContentsDelegate* delegate) = 0;
 
-  // Gets the controller for this tab contents.
+  // Gets the controller for this WebContents.
   virtual NavigationController& GetController() = 0;
   virtual const NavigationController& GetController() const = 0;
 
   // Returns the user browser context associated with this WebContents (via the
   // NavigationController).
   virtual content::BrowserContext* GetBrowserContext() const = 0;
 
   // Allows overriding the type of this tab.
   virtual void SetViewType(content::ViewType type) = 0;
   virtual content::ViewType GetViewType() const = 0;
@@ skipping 44 matching lines @@
   // this WebContents.
   virtual int32 GetMaxPageIDForSiteInstance(SiteInstance* site_instance) = 0;
 
   // Returns the SiteInstance associated with the current page.
   virtual SiteInstance* GetSiteInstance() const = 0;
 
   // Returns the SiteInstance for the pending navigation, if any.  Otherwise
   // returns the current SiteInstance.
   virtual SiteInstance* GetPendingSiteInstance() const = 0;
 
-  // Return whether this tab contents is loading a resource.
+  // Return whether this WebContents is loading a resource.
   virtual bool IsLoading() const = 0;
 
-  // Returns whether this tab contents is waiting for a first-response for the
+  // Returns whether this WebContents is waiting for a first-response for the
   // main resource of the page.
   virtual bool IsWaitingForResponse() const = 0;
 
   // Return the current load state and the URL associated with it.
   virtual const net::LoadStateWithParam& GetLoadState() const = 0;
   virtual const string16& GetLoadStateHost() const = 0;
 
   // Return the upload progress.
   virtual uint64 GetUploadSize() const = 0;
   virtual uint64 GetUploadPosition() const = 0;
 
   // Return the character encoding of the page.
   virtual const std::string& GetEncoding() const = 0;
 
   // True if this is a secure page which displayed insecure content.
   virtual bool DisplayedInsecureContent() const = 0;
 
   // Internal state ------------------------------------------------------------
 
-  // This flag indicates whether the tab contents is currently being
-  // screenshotted by the DraggedTabController.
+  // This flag indicates whether the WebContents is currently being
+  // screenshotted.
   virtual void SetCapturingContents(bool cap)  = 0;
 
   // Indicates whether this tab should be considered crashed. The setter will
   // also notify the delegate when the flag is changed.
   virtual bool IsCrashed() const  = 0;
   virtual void SetIsCrashed(base::TerminationStatus status, int error_code) = 0;
 
   virtual base::TerminationStatus GetCrashedStatus() const  = 0;
 
   // Whether the tab is in the process of being destroyed.
   // Added as a tentative work-around for focus related bug #4633.  This allows
   // us not to store focus when a tab is being closed.
   virtual bool IsBeingDestroyed() const  = 0;
 
   // Convenience method for notifying the delegate of a navigation state
   // change. See InvalidateType enum.
   virtual void NotifyNavigationStateChanged(unsigned changed_flags) = 0;
 
-  // Invoked when the tab contents becomes selected. If you override, be sure
+  // Invoked when the WebContents becomes selected. If you override, be sure
   // and invoke super's implementation.
   virtual void DidBecomeSelected() = 0;
   virtual base::TimeTicks GetLastSelectedTime() const = 0;
 
-  // Invoked when the tab contents becomes hidden.
+  // Invoked when the WebContents becomes hidden.
   // NOTE: If you override this, call the superclass version too!
   virtual void WasHidden() = 0;
 
   // TODO(brettw) document these.
   virtual void ShowContents() = 0;
   virtual void HideContents() = 0;
 
   // Returns true if the before unload and unload listeners need to be
   // fired. The value of this changes over time. For example, if true and the
   // before unload listener is executed and allows the user to exit, then this
@@ skipping 99 matching lines @@
   virtual base::TimeTicks GetNewTabStartTime() const = 0;
 
   // Notification that tab closing has started.  This can be called multiple
   // times, subsequent calls are ignored.
   virtual void OnCloseStarted() = 0;
 
   // Returns true if underlying WebContentsView should accept drag-n-drop.
   virtual bool ShouldAcceptDragAndDrop() const = 0;
 
   // A render view-originated drag has ended. Informs the render view host and
-  // tab contents delegate.
+  // WebContentsDelegate.
   virtual void SystemDragEnded() = 0;
 
   // Indicates if this tab was explicitly closed by the user (control-w, close
   // tab menu item...). This is false for actions that indirectly close the tab,
   // such as closing the window.  The setter is maintained by TabStripModel, and
   // the getter only useful from within TAB_CLOSED notification
   virtual void SetClosedByUserGesture(bool value) = 0;
   virtual bool GetClosedByUserGesture() const = 0;
 
   // Gets the zoom level for this tab.
@@ skipping 46 matching lines @@
   // Focuses the location bar.
   virtual void SetFocusToLocationBar(bool select_all) = 0;
 
   // Does this have an opener associated with it?
   virtual bool HasOpener() const = 0;
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_H_