Index: chrome/browser/tab_contents/tab_contents_delegate.h |
=================================================================== |
--- chrome/browser/tab_contents/tab_contents_delegate.h (revision 75368) |
+++ chrome/browser/tab_contents/tab_contents_delegate.h (working copy) |
@@ -6,323 +6,7 @@ |
#define CHROME_BROWSER_TAB_CONTENTS_TAB_CONTENTS_DELEGATE_H_ |
#pragma once |
-#include <string> |
-#include <vector> |
+// TODO(jam): remove this file when all files have been converted. |
+#include "content/browser/tab_contents/tab_contents_delegate.h" |
-#include "base/basictypes.h" |
-#include "chrome/browser/automation/automation_resource_routing_delegate.h" |
-#include "chrome/browser/tab_contents/navigation_entry.h" |
-#include "chrome/common/content_settings_types.h" |
-#include "chrome/common/navigation_types.h" |
-#include "chrome/common/page_transition_types.h" |
-#include "ui/gfx/native_widget_types.h" |
-#include "webkit/glue/window_open_disposition.h" |
- |
-namespace gfx { |
-class Point; |
-class Rect; |
-class Size; |
-} |
- |
-namespace history { |
-class HistoryAddPageArgs; |
-} |
- |
-struct ContextMenuParams; |
-class DownloadItem; |
-class GURL; |
-class HtmlDialogUIDelegate; |
-struct NativeWebKeyboardEvent; |
-class Profile; |
-class RenderViewHost; |
-class TabContents; |
-struct WebApplicationInfo; |
- |
-// Objects implement this interface to get notified about changes in the |
-// TabContents and to provide necessary functionality. |
-class TabContentsDelegate : public AutomationResourceRoutingDelegate { |
- public: |
- // Opens a new URL inside the passed in TabContents (if source is 0 open |
- // in the current front-most tab), unless |disposition| indicates the url |
- // should be opened in a new tab or window. |
- // |
- // A NULL source indicates the current tab (callers should probably use |
- // OpenURL() for these cases which does it for you). |
- virtual void OpenURLFromTab(TabContents* source, |
- const GURL& url, const GURL& referrer, |
- WindowOpenDisposition disposition, |
- PageTransition::Type transition) = 0; |
- |
- // Called to inform the delegate that the tab content's navigation state |
- // changed. The |changed_flags| indicates the parts of the navigation state |
- // that have been updated, and is any combination of the |
- // |TabContents::InvalidateTypes| bits. |
- virtual void NavigationStateChanged(const TabContents* source, |
- unsigned changed_flags) = 0; |
- |
- // Returns the set of headers to add to the navigation request. Use |
- // net::HttpUtil::AppendHeaderIfMissing to build the set of headers. |
- virtual std::string GetNavigationHeaders(const GURL& url); |
- |
- // Creates a new tab with the already-created TabContents 'new_contents'. |
- // The window for the added contents should be reparented correctly when this |
- // method returns. If |disposition| is NEW_POPUP, |pos| should hold the |
- // initial position. |
- virtual void AddNewContents(TabContents* source, |
- TabContents* new_contents, |
- WindowOpenDisposition disposition, |
- const gfx::Rect& initial_pos, |
- bool user_gesture) = 0; |
- |
- // Selects the specified contents, bringing its container to the front. |
- virtual void ActivateContents(TabContents* contents) = 0; |
- |
- // Deactivates the specified contents by deactivating its container and |
- // potentialy moving it to the back of the Z order. |
- virtual void DeactivateContents(TabContents* contents) = 0; |
- |
- // Notifies the delegate that this contents is starting or is done loading |
- // some resource. The delegate should use this notification to represent |
- // loading feedback. See TabContents::is_loading() |
- virtual void LoadingStateChanged(TabContents* source) = 0; |
- |
- // Notifies the delegate that the page has made some progress loading. |
- // |progress| is a value between 0.0 (nothing loaded) to 1.0 (page fully |
- // loaded). |
- // Note that to receive this notification, you must have called |
- // SetReportLoadProgressEnabled(true) in the render view. |
- virtual void LoadProgressChanged(double progress); |
- |
- // Request the delegate to close this tab contents, and do whatever cleanup |
- // it needs to do. |
- virtual void CloseContents(TabContents* source) = 0; |
- |
- // Request the delegate to move this tab contents to the specified position |
- // in screen coordinates. |
- virtual void MoveContents(TabContents* source, const gfx::Rect& pos) = 0; |
- |
- // Causes the delegate to detach |source| and clean up any internal data |
- // pointing to it. After this call ownership of |source| passes to the |
- // caller, and it is safe to call "source->set_delegate(someone_else);". |
- virtual void DetachContents(TabContents* source); |
- |
- // Called to determine if the TabContents is contained in a popup window. |
- virtual bool IsPopup(const TabContents* source) const; |
- |
- // If |source| is constrained, returns the tab containing it. Otherwise |
- // returns |source|. |
- virtual TabContents* GetConstrainingContents(TabContents* source); |
- |
- // Returns true if constrained windows should be focused. Default is true. |
- virtual bool ShouldFocusConstrainedWindow(); |
- |
- // Invoked prior to the TabContents showing a constrained window. |
- virtual void WillShowConstrainedWindow(TabContents* source); |
- |
- // Notification that some of our content has changed size as |
- // part of an animation. |
- virtual void ToolbarSizeChanged(TabContents* source, bool is_animating) = 0; |
- |
- // Notification that the target URL has changed. |
- virtual void UpdateTargetURL(TabContents* source, const GURL& url) = 0; |
- |
- // Notification that there was a mouse event, along with the absolute |
- // coordinates of the mouse pointer and whether it was a normal motion event |
- // (otherwise, the pointer left the contents area). |
- virtual void ContentsMouseEvent( |
- TabContents* source, const gfx::Point& location, bool motion); |
- |
- // Request the delegate to change the zoom level of the current tab. |
- virtual void ContentsZoomChange(bool zoom_in); |
- |
- // Notifies the delegate that something has changed about what content the |
- // TabContents is blocking. Interested parties should call |
- // TabContents::IsContentBlocked() to see if something they care about has |
- // changed. |
- virtual void OnContentSettingsChange(TabContents* source); |
- |
- // Check whether this contents is inside a window dedicated to running a web |
- // application. |
- virtual bool IsApplication() const; |
- |
- // Detach the given tab and convert it to a "webapp" view. The tab must be |
- // a TabContents with a valid WebApp set. |
- virtual void ConvertContentsToApplication(TabContents* source); |
- |
- // Whether the specified tab can be reloaded. |
- // Reloading can be disabled e. g. for the DevTools window. |
- virtual bool CanReloadContents(TabContents* source) const; |
- |
- // Show a dialog with HTML content. |delegate| contains a pointer to the |
- // delegate who knows how to display the dialog (which file URL and JSON |
- // string input to use during initialization). |parent_window| is the window |
- // that should be parent of the dialog, or NULL for the default. |
- virtual void ShowHtmlDialog(HtmlDialogUIDelegate* delegate, |
- gfx::NativeWindow parent_window); |
- |
- // Invoked prior to showing before unload handler confirmation dialog. |
- virtual void WillRunBeforeUnloadConfirm(); |
- |
- // Returns true if javascript dialogs and unload alerts are suppressed. |
- // Default is false. |
- virtual bool ShouldSuppressDialogs(); |
- |
- // Tells us that we've finished firing this tab's beforeunload event. |
- // The proceed bool tells us whether the user chose to proceed closing the |
- // tab. Returns true if the tab can continue on firing it's unload event. |
- // If we're closing the entire browser, then we'll want to delay firing |
- // unload events until all the beforeunload events have fired. |
- virtual void BeforeUnloadFired(TabContents* tab, |
- bool proceed, |
- bool* proceed_to_fire_unload); |
- |
- // Send IPC to external host. Default implementation is do nothing. |
- virtual void ForwardMessageToExternalHost(const std::string& message, |
- const std::string& origin, |
- const std::string& target); |
- |
- // If the delegate is hosting tabs externally. |
- virtual bool IsExternalTabContainer() const; |
- |
- // Sets focus to the location bar or some other place that is appropriate. |
- // This is called when the tab wants to encourage user input, like for the |
- // new tab page. |
- virtual void SetFocusToLocationBar(bool select_all); |
- |
- // Returns whether the page should be focused when transitioning from crashed |
- // to live. Default is true. |
- virtual bool ShouldFocusPageAfterCrash(); |
- |
- // Called when a popup select is about to be displayed. The delegate can use |
- // this to disable inactive rendering for the frame in the window the select |
- // is opened within if necessary. |
- virtual void RenderWidgetShowing(); |
- |
- // This is called when WebKit tells us that it is done tabbing through |
- // controls on the page. Provides a way for TabContentsDelegates to handle |
- // this. Returns true if the delegate successfully handled it. |
- virtual bool TakeFocus(bool reverse); |
- |
- // Invoked when the page loses mouse capture. |
- virtual void LostCapture(); |
- |
- // Changes the blocked state of the tab at |index|. TabContents are |
- // considered blocked while displaying a tab modal dialog. During that time |
- // renderer host will ignore any UI interaction within TabContent outside of |
- // the currently displaying dialog. |
- virtual void SetTabContentBlocked(TabContents* contents, bool blocked); |
- |
- // Notification that |tab_contents| has gained focus. |
- virtual void TabContentsFocused(TabContents* tab_content); |
- |
- // Return much extra vertical space should be allotted to the |
- // render view widget during various animations (e.g. infobar closing). |
- // This is used to make painting look smoother. |
- virtual int GetExtraRenderViewHeight() const; |
- |
- virtual bool CanDownload(int request_id); |
- |
- virtual void OnStartDownload(DownloadItem* download, TabContents* tab); |
- |
- // Returns true if the context menu operation was handled by the delegate. |
- virtual bool HandleContextMenu(const ContextMenuParams& params); |
- |
- // Returns true if the context menu command was handled |
- virtual bool ExecuteContextMenuCommand(int command); |
- |
- // Shows the page info using the specified information. |
- // |url| is the url of the page/frame the info applies to, |ssl| is the SSL |
- // information for that page/frame. If |show_history| is true, a section |
- // showing how many times that URL has been visited is added to the page info. |
- virtual void ShowPageInfo(Profile* profile, |
- const GURL& url, |
- const NavigationEntry::SSLStatus& ssl, |
- bool show_history); |
- |
- // Opens source view for given tab contents that is navigated to the given |
- // page url. |
- virtual void ViewSourceForTab(TabContents* source, const GURL& page_url); |
- |
- // Allows delegates to handle keyboard events before sending to the renderer. |
- // Returns true if the |event| was handled. Otherwise, if the |event| would be |
- // handled in HandleKeyboardEvent() method as a normal keyboard shortcut, |
- // |*is_keyboard_shortcut| should be set to true. |
- virtual bool PreHandleKeyboardEvent(const NativeWebKeyboardEvent& event, |
- bool* is_keyboard_shortcut); |
- |
- // Allows delegates to handle unhandled keyboard messages coming back from |
- // the renderer. |
- virtual void HandleKeyboardEvent(const NativeWebKeyboardEvent& event); |
- |
- virtual void HandleMouseUp(); |
- virtual void HandleMouseActivate(); |
- |
- // Render view drag n drop ended. |
- virtual void DragEnded(); |
- |
- // Shows the repost form confirmation dialog box. |
- virtual void ShowRepostFormWarningDialog(TabContents* tab_contents); |
- |
- // Shows the Content Settings dialog for a given content type. |
- virtual void ShowContentSettingsWindow(ContentSettingsType content_type); |
- |
- // Shows the cookies collected in the tab contents. |
- virtual void ShowCollectedCookiesDialog(TabContents* tab_contents); |
- |
- // Allows delegate to override navigation to the history entries. |
- // Returns true to allow TabContents to continue with the default processing. |
- virtual bool OnGoToEntryOffset(int offset); |
- |
- // Returns whether this tab contents should add the specified navigation to |
- // history. |
- virtual bool ShouldAddNavigationToHistory( |
- const history::HistoryAddPageArgs& add_page_args, |
- NavigationType::Type navigation_type); |
- |
- // Notification that a user's request to install an application has completed. |
- virtual void OnDidGetApplicationInfo(TabContents* tab_contents, |
- int32 page_id); |
- |
- // Notification when an application programmatically requests installation. |
- virtual void OnInstallApplication(TabContents* tab_contents, |
- const WebApplicationInfo& app_info); |
- |
- // Returns the native window framing the view containing the tab contents. |
- virtual gfx::NativeWindow GetFrameNativeWindow(); |
- |
- // Notifies the delegate about the creation of a new TabContents. This |
- // typically happens when popups are created. |
- virtual void TabContentsCreated(TabContents* new_contents); |
- |
- // Returns whether infobars are enabled. Overrideable by child classes. |
- virtual bool infobars_enabled(); |
- |
- // Whether the renderer should report its preferred size when it changes by |
- // calling UpdatePreferredSize(). |
- // Note that this is set when the RenderViewHost is created and cannot be |
- // changed after that. |
- virtual bool ShouldEnablePreferredSizeNotifications(); |
- |
- // Notification that the preferred size of the contents has changed. |
- // Only called if ShouldEnablePreferredSizeNotifications() returns true. |
- virtual void UpdatePreferredSize(const gfx::Size& pref_size); |
- |
- // Notifies the delegate that the page has a suggest result. |
- virtual void OnSetSuggestions(int32 page_id, |
- const std::vector<std::string>& result); |
- |
- // Notifies the delegate whether the page supports instant-style interaction. |
- virtual void OnInstantSupportDetermined(int32 page_id, bool result); |
- |
- // Notifies the delegate that the content restrictions for this tab has |
- // changed. |
- virtual void ContentRestrictionsChanged(TabContents* source); |
- |
- // Returns true if the hung renderer dialog should be shown. Default is true. |
- virtual bool ShouldShowHungRendererDialog(); |
- |
- protected: |
- virtual ~TabContentsDelegate(); |
-}; |
- |
#endif // CHROME_BROWSER_TAB_CONTENTS_TAB_CONTENTS_DELEGATE_H_ |