1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #ifndef CHROME_BROWSER_UI_BROWSER_H_
6 #define CHROME_BROWSER_UI_BROWSER_H_
13 #include "base/basictypes.h"
14 #include "base/compiler_specific.h"
15 #include "base/gtest_prod_util.h"
16 #include "base/memory/scoped_ptr.h"
17 #include "base/memory/weak_ptr.h"
18 #include "base/prefs/pref_change_registrar.h"
19 #include "base/prefs/pref_member.h"
20 #include "base/strings/string16.h"
21 #include "chrome/browser/devtools/devtools_toggle_action.h"
22 #include "chrome/browser/sessions/session_id.h"
23 #include "chrome/browser/ui/bookmarks/bookmark_bar.h"
24 #include "chrome/browser/ui/bookmarks/bookmark_tab_helper_delegate.h"
25 #include "chrome/browser/ui/browser_navigator.h"
26 #include "chrome/browser/ui/chrome_web_modal_dialog_manager_delegate.h"
27 #include "chrome/browser/ui/host_desktop.h"
28 #include "chrome/browser/ui/search_engines/search_engine_tab_helper_delegate.h"
29 #include "chrome/browser/ui/tab_contents/core_tab_helper_delegate.h"
30 #include "chrome/browser/ui/tabs/tab_strip_model_observer.h"
31 #include "chrome/browser/ui/toolbar/toolbar_model.h"
32 #include "chrome/browser/ui/zoom/zoom_observer.h"
33 #include "chrome/common/content_settings.h"
34 #include "chrome/common/content_settings_types.h"
35 #include "chrome/common/extensions/extension_constants.h"
36 #include "content/public/browser/notification_observer.h"
37 #include "content/public/browser/notification_registrar.h"
38 #include "content/public/browser/page_navigator.h"
39 #include "content/public/browser/web_contents_delegate.h"
40 #include "content/public/common/page_transition_types.h"
41 #include "content/public/common/page_zoom.h"
42 #include "ui/base/ui_base_types.h"
43 #include "ui/base/window_open_disposition.h"
44 #include "ui/gfx/rect.h"
45 #include "ui/shell_dialogs/select_file_dialog.h"
47 class BrowserContentSettingBubbleModelDelegate
;
48 class BrowserInstantController
;
49 class BrowserLanguageStateObserver
;
50 class BrowserSyncedWindowDelegate
;
51 class BrowserToolbarModelDelegate
;
52 class BrowserTabRestoreServiceDelegate
;
54 class FindBarController
;
55 class FullscreenController
;
62 class TabStripModelDelegate
;
63 struct WebApplicationInfo
;
66 class BrowserCommandController
;
67 class FastUnloadController
;
68 class UnloadController
;
69 class ValidationMessageBubble
;
73 class NavigationController
;
75 class SessionStorageNamespace
;
78 namespace extensions
{
80 class WindowController
;
89 struct SelectedFileInfo
;
90 class WebDialogDelegate
;
94 class WebContentsModalDialogHost
;
97 class Browser
: public TabStripModelObserver
,
98 public content::WebContentsDelegate
,
99 public CoreTabHelperDelegate
,
100 public SearchEngineTabHelperDelegate
,
101 public ChromeWebModalDialogManagerDelegate
,
102 public BookmarkTabHelperDelegate
,
104 public content::PageNavigator
,
105 public content::NotificationObserver
,
106 public ui::SelectFileDialog::Listener
{
108 // SessionService::WindowType mirrors these values. If you add to this
109 // enum, look at SessionService::WindowType to see if it needs to be
112 // If you add a new type, consider updating the test
113 // BrowserTest.StartMaximized.
118 // Distinguishes between browsers that host an app (opened from
119 // ApplicationLauncher::OpenApplication), and child browsers created by an app
120 // from Browser::CreateForApp (e.g. by windows.open or the extension API).
126 // Possible elements of the Browser window.
129 FEATURE_TITLEBAR
= 1,
130 FEATURE_TABSTRIP
= 2,
132 FEATURE_LOCATIONBAR
= 8,
133 FEATURE_BOOKMARKBAR
= 16,
134 FEATURE_INFOBAR
= 32,
135 FEATURE_DOWNLOADSHELF
= 64
138 // The context for a download blocked notification from
139 // OkToCloseWithInProgressDownloads.
140 enum DownloadClosePreventionType
{
141 // Browser close is not blocked by download state.
144 // The browser is shutting down and there are active downloads
145 // that would be cancelled.
146 DOWNLOAD_CLOSE_BROWSER_SHUTDOWN
,
148 // There are active downloads associated with this incognito profile
149 // that would be canceled.
150 DOWNLOAD_CLOSE_LAST_WINDOW_IN_INCOGNITO_PROFILE
,
153 struct CreateParams
{
154 CreateParams(Profile
* profile
, chrome::HostDesktopType host_desktop_type
);
155 CreateParams(Type type
,
157 chrome::HostDesktopType host_desktop_type
);
159 static CreateParams
CreateForApp(Type type
,
160 const std::string
& app_name
,
161 const gfx::Rect
& window_bounds
,
163 chrome::HostDesktopType host_desktop_type
);
165 static CreateParams
CreateForDevTools(
167 chrome::HostDesktopType host_desktop_type
);
172 // The associated profile.
175 // The host desktop the browser is created on.
176 chrome::HostDesktopType host_desktop_type
;
178 // The application name that is also the name of the window to the shell.
179 // This name should be set when:
180 // 1) we launch an application via an application shortcut or extension API.
181 // 2) we launch an undocked devtool window.
182 std::string app_name
;
184 // Type of app (host or child). See description of AppType.
187 // The bounds of the window to open.
188 gfx::Rect initial_bounds
;
190 ui::WindowShowState initial_show_state
;
192 bool is_session_restore
;
194 // Supply a custom BrowserWindow implementation, to be used instead of the
195 // default. Intended for testing.
196 BrowserWindow
* window
;
199 // Constructors, Creation, Showing //////////////////////////////////////////
201 explicit Browser(const CreateParams
& params
);
204 // Set overrides for the initial window bounds and maximized state.
205 void set_override_bounds(const gfx::Rect
& bounds
) {
206 override_bounds_
= bounds
;
208 ui::WindowShowState
initial_show_state() const { return initial_show_state_
; }
209 void set_initial_show_state(ui::WindowShowState initial_show_state
) {
210 initial_show_state_
= initial_show_state
;
212 // Return true if the initial window bounds have been overridden.
213 bool bounds_overridden() const {
214 return !override_bounds_
.IsEmpty();
216 // Set indicator that this browser is being created via session restore.
217 // This is used on the Mac (only) to determine animation style when the
218 // browser window is shown.
219 void set_is_session_restore(bool is_session_restore
) {
220 is_session_restore_
= is_session_restore
;
222 bool is_session_restore() const {
223 return is_session_restore_
;
225 chrome::HostDesktopType
host_desktop_type() const {
226 return host_desktop_type_
;
229 // Accessors ////////////////////////////////////////////////////////////////
231 Type
type() const { return type_
; }
232 const std::string
& app_name() const { return app_name_
; }
233 AppType
app_type() const { return app_type_
; }
234 Profile
* profile() const { return profile_
; }
235 gfx::Rect
override_bounds() const { return override_bounds_
; }
237 // |window()| will return NULL if called before |CreateBrowserWindow()|
239 BrowserWindow
* window() const { return window_
; }
240 ToolbarModel
* toolbar_model() { return toolbar_model_
.get(); }
241 const ToolbarModel
* toolbar_model() const { return toolbar_model_
.get(); }
242 #if defined(UNIT_TEST)
243 void swap_toolbar_models(scoped_ptr
<ToolbarModel
>* toolbar_model
) {
244 toolbar_model
->swap(toolbar_model_
);
247 TabStripModel
* tab_strip_model() const { return tab_strip_model_
.get(); }
248 chrome::BrowserCommandController
* command_controller() {
249 return command_controller_
.get();
251 SearchModel
* search_model() { return search_model_
.get(); }
252 const SearchModel
* search_model() const {
253 return search_model_
.get();
255 SearchDelegate
* search_delegate() {
256 return search_delegate_
.get();
258 const SessionID
& session_id() const { return session_id_
; }
259 BrowserContentSettingBubbleModelDelegate
*
260 content_setting_bubble_model_delegate() {
261 return content_setting_bubble_model_delegate_
.get();
263 BrowserTabRestoreServiceDelegate
* tab_restore_service_delegate() {
264 return tab_restore_service_delegate_
.get();
266 BrowserSyncedWindowDelegate
* synced_window_delegate() {
267 return synced_window_delegate_
.get();
269 BrowserInstantController
* instant_controller() {
270 return instant_controller_
.get();
273 // Get the FindBarController for this browser, creating it if it does not
275 FindBarController
* GetFindBarController();
277 // Returns true if a FindBarController exists for this browser.
278 bool HasFindBarController() const;
280 // Returns the state of the bookmark bar.
281 BookmarkBar::State
bookmark_bar_state() const { return bookmark_bar_state_
; }
283 // State Storage and Retrieval for UI ///////////////////////////////////////
285 // Gets the Favicon of the page in the selected tab.
286 gfx::Image
GetCurrentPageIcon() const;
288 // Gets the title of the window based on the selected tab's title.
289 base::string16
GetWindowTitleForCurrentTab() const;
291 // Prepares a title string for display (removes embedded newlines, etc).
292 static void FormatTitleForDisplay(base::string16
* title
);
294 // OnBeforeUnload handling //////////////////////////////////////////////////
296 // Gives beforeunload handlers the chance to cancel the close. Returns whether
297 // to proceed with the close. If called while the process begun by
298 // CallBeforeUnloadHandlers is in progress, returns false without taking
300 bool ShouldCloseWindow();
302 // Begins the process of confirming whether the associated browser can be
303 // closed. If there are no tabs with beforeunload handlers it will immediately
304 // return false. Otherwise, it starts prompting the user, returns true and
305 // will call |on_close_confirmed| with the result of the user's decision.
306 // After calling this function, if the window will not be closed, call
307 // ResetBeforeUnloadHandlers() to reset all beforeunload handlers; calling
308 // this function multiple times without an intervening call to
309 // ResetBeforeUnloadHandlers() will run only the beforeunload handlers
310 // registered since the previous call.
311 bool CallBeforeUnloadHandlers(
312 const base::Callback
<void(bool)>& on_close_confirmed
);
314 // Clears the results of any beforeunload confirmation dialogs triggered by a
315 // CallBeforeUnloadHandlers call.
316 void ResetBeforeUnloadHandlers();
318 // Figure out if there are tabs that have beforeunload handlers.
319 // It starts beforeunload/unload processing as a side-effect.
320 bool TabsNeedBeforeUnloadFired();
322 // Returns true if all tabs' beforeunload/unload events have fired.
323 bool HasCompletedUnloadProcessing() const;
325 bool IsAttemptingToCloseBrowser() const;
327 // Invoked when the window containing us is closing. Performs the necessary
329 void OnWindowClosing();
331 // In-progress download termination handling /////////////////////////////////
333 // Called when the user has decided whether to proceed or not with the browser
334 // closure. |cancel_downloads| is true if the downloads should be canceled
335 // and the browser closed, false if the browser should stay open and the
336 // downloads running.
337 void InProgressDownloadResponse(bool cancel_downloads
);
339 // Indicates whether or not this browser window can be closed, or
340 // would be blocked by in-progress downloads.
341 // If executing downloads would be cancelled by this window close,
342 // then |*num_downloads_blocking| is updated with how many downloads
343 // would be canceled if the close continued.
344 DownloadClosePreventionType
OkToCloseWithInProgressDownloads(
345 int* num_downloads_blocking
) const;
347 // External state change handling ////////////////////////////////////////////
349 // Invoked when the fullscreen state of the window changes.
350 // BrowserWindow::EnterFullscreen invokes this after the window has become
352 void WindowFullscreenStateChanged();
354 // Invoked when visible SSL state (as defined by SSLStatus) changes.
355 void VisibleSSLStateChanged(content::WebContents
* web_contents
);
357 // Invoked when the |web_contents| no longer supports Instant. Refreshes the
358 // omnibox so it no longer shows search terms.
359 void OnWebContentsInstantSupportDisabled(
360 const content::WebContents
* web_contents
);
362 // Assorted browser commands ////////////////////////////////////////////////
364 // NOTE: Within each of the following sections, the IDs are ordered roughly by
365 // how they appear in the GUI/menus (left to right, top to bottom, etc.).
367 // See the description of
368 // FullscreenController::ToggleFullscreenModeWithExtension.
369 void ToggleFullscreenModeWithExtension(const GURL
& extension_url
);
371 // See the description of FullscreenController::ToggleMetroSnapMode.
372 void SetMetroSnapMode(bool enable
);
375 // Returns true if the Browser supports the specified feature. The value of
376 // this varies during the lifetime of the browser. For example, if the window
377 // is fullscreen this may return a different value. If you only care about
378 // whether or not it's possible for the browser to support a particular
379 // feature use |CanSupportWindowFeature|.
380 bool SupportsWindowFeature(WindowFeature feature
) const;
382 // Returns true if the Browser can support the specified feature. See comment
383 // in |SupportsWindowFeature| for details on this.
384 bool CanSupportWindowFeature(WindowFeature feature
) const;
386 // TODO(port): port these, and re-merge the two function declaration lists.
387 // Page-related commands.
388 void ToggleEncodingAutoDetect();
389 void OverrideEncoding(int encoding_id
);
391 // Show various bits of UI
394 void UpdateDownloadShelfVisibility(bool visible
);
396 /////////////////////////////////////////////////////////////////////////////
398 // Called by chrome::Navigate() when a navigation has occurred in a tab in
399 // this Browser. Updates the UI for the start of this navigation.
400 void UpdateUIForNavigationInTab(content::WebContents
* contents
,
401 content::PageTransition transition
,
402 bool user_initiated
);
404 // Interface implementations ////////////////////////////////////////////////
406 // Overridden from content::PageNavigator:
407 virtual content::WebContents
* OpenURL(
408 const content::OpenURLParams
& params
) OVERRIDE
;
410 // Overridden from TabStripModelObserver:
411 virtual void TabInsertedAt(content::WebContents
* contents
,
413 bool foreground
) OVERRIDE
;
414 virtual void TabClosingAt(TabStripModel
* tab_strip_model
,
415 content::WebContents
* contents
,
417 virtual void TabDetachedAt(content::WebContents
* contents
,
419 virtual void TabDeactivated(content::WebContents
* contents
) OVERRIDE
;
420 virtual void ActiveTabChanged(content::WebContents
* old_contents
,
421 content::WebContents
* new_contents
,
423 int reason
) OVERRIDE
;
424 virtual void TabMoved(content::WebContents
* contents
,
426 int to_index
) OVERRIDE
;
427 virtual void TabReplacedAt(TabStripModel
* tab_strip_model
,
428 content::WebContents
* old_contents
,
429 content::WebContents
* new_contents
,
431 virtual void TabPinnedStateChanged(content::WebContents
* contents
,
433 virtual void TabStripEmpty() OVERRIDE
;
435 // Overridden from content::WebContentsDelegate:
436 virtual bool CanOverscrollContent() const OVERRIDE
;
437 virtual bool PreHandleKeyboardEvent(
438 content::WebContents
* source
,
439 const content::NativeWebKeyboardEvent
& event
,
440 bool* is_keyboard_shortcut
) OVERRIDE
;
441 virtual void HandleKeyboardEvent(
442 content::WebContents
* source
,
443 const content::NativeWebKeyboardEvent
& event
) OVERRIDE
;
444 virtual void OverscrollUpdate(int delta_y
) OVERRIDE
;
445 virtual void ShowValidationMessage(content::WebContents
* web_contents
,
446 const gfx::Rect
& anchor_in_root_view
,
447 const base::string16
& main_text
,
448 const base::string16
& sub_text
) OVERRIDE
;
449 virtual void HideValidationMessage(
450 content::WebContents
* web_contents
) OVERRIDE
;
451 virtual void MoveValidationMessage(
452 content::WebContents
* web_contents
,
453 const gfx::Rect
& anchor_in_root_view
) OVERRIDE
;
455 bool is_type_tabbed() const { return type_
== TYPE_TABBED
; }
456 bool is_type_popup() const { return type_
== TYPE_POPUP
; }
459 bool is_devtools() const;
461 // True when the mouse cursor is locked.
462 bool IsMouseLocked() const;
464 // Called each time the browser window is shown.
465 void OnWindowDidShow();
467 // Show the first run search engine bubble on the location bar.
468 void ShowFirstRunBubble();
470 // Show a download on the download shelf.
471 void ShowDownload(content::DownloadItem
* download
);
473 FullscreenController
* fullscreen_controller() const {
474 return fullscreen_controller_
.get();
477 extensions::WindowController
* extension_window_controller() const {
478 return extension_window_controller_
.get();
482 friend class BrowserTest
;
483 friend class FullscreenControllerInteractiveTest
;
484 friend class FullscreenControllerTest
;
485 FRIEND_TEST_ALL_PREFIXES(AppModeTest
, EnableAppModeTest
);
486 FRIEND_TEST_ALL_PREFIXES(BrowserCommandControllerTest
,
487 IsReservedCommandOrKeyIsApp
);
488 FRIEND_TEST_ALL_PREFIXES(BrowserCommandControllerTest
, AppFullScreen
);
489 FRIEND_TEST_ALL_PREFIXES(BrowserTest
, NoTabsInPopups
);
490 FRIEND_TEST_ALL_PREFIXES(BrowserTest
, ConvertTabToAppShortcut
);
491 FRIEND_TEST_ALL_PREFIXES(BrowserTest
, OpenAppWindowLikeNtp
);
492 FRIEND_TEST_ALL_PREFIXES(BrowserTest
, AppIdSwitch
);
493 FRIEND_TEST_ALL_PREFIXES(FullscreenControllerTest
,
494 TabEntersPresentationModeFromWindowed
);
495 FRIEND_TEST_ALL_PREFIXES(FullscreenExitBubbleControllerTest
,
496 DenyExitsFullscreen
);
497 FRIEND_TEST_ALL_PREFIXES(StartupBrowserCreatorTest
, OpenAppShortcutNoPref
);
498 FRIEND_TEST_ALL_PREFIXES(StartupBrowserCreatorTest
,
499 OpenAppShortcutWindowPref
);
500 FRIEND_TEST_ALL_PREFIXES(StartupBrowserCreatorTest
, OpenAppShortcutTabPref
);
502 class InterstitialObserver
;
504 // Used to describe why a tab is being detached. This is used by
505 // TabDetachedAtImpl.
507 // Result of TabDetachedAt.
510 // Result of TabReplacedAt.
513 // Result of the tab strip not having any significant tabs.
517 // Describes where the bookmark bar state change originated from.
518 enum BookmarkBarStateChangeReason
{
519 // From the constructor.
520 BOOKMARK_BAR_STATE_CHANGE_INIT
,
522 // Change is the result of the active tab changing.
523 BOOKMARK_BAR_STATE_CHANGE_TAB_SWITCH
,
525 // Change is the result of the bookmark bar pref changing.
526 BOOKMARK_BAR_STATE_CHANGE_PREF_CHANGE
,
528 // Change is the result of a state change in the active tab.
529 BOOKMARK_BAR_STATE_CHANGE_TAB_STATE
,
531 // Change is the result of window toggling in/out of fullscreen mode.
532 BOOKMARK_BAR_STATE_CHANGE_TOGGLE_FULLSCREEN
,
535 // Overridden from content::WebContentsDelegate:
536 virtual content::WebContents
* OpenURLFromTab(
537 content::WebContents
* source
,
538 const content::OpenURLParams
& params
) OVERRIDE
;
539 virtual void NavigationStateChanged(const content::WebContents
* source
,
540 unsigned changed_flags
) OVERRIDE
;
541 virtual void AddNewContents(content::WebContents
* source
,
542 content::WebContents
* new_contents
,
543 WindowOpenDisposition disposition
,
544 const gfx::Rect
& initial_pos
,
546 bool* was_blocked
) OVERRIDE
;
547 virtual void ActivateContents(content::WebContents
* contents
) OVERRIDE
;
548 virtual void DeactivateContents(content::WebContents
* contents
) OVERRIDE
;
549 virtual void LoadingStateChanged(content::WebContents
* source
) OVERRIDE
;
550 virtual void CloseContents(content::WebContents
* source
) OVERRIDE
;
551 virtual void MoveContents(content::WebContents
* source
,
552 const gfx::Rect
& pos
) OVERRIDE
;
553 virtual bool IsPopupOrPanel(
554 const content::WebContents
* source
) const OVERRIDE
;
555 virtual void UpdateTargetURL(content::WebContents
* source
, int32 page_id
,
556 const GURL
& url
) OVERRIDE
;
557 virtual void ContentsMouseEvent(content::WebContents
* source
,
558 const gfx::Point
& location
,
559 bool motion
) OVERRIDE
;
560 virtual void ContentsZoomChange(bool zoom_in
) OVERRIDE
;
561 virtual void WebContentsFocused(content::WebContents
* content
) OVERRIDE
;
562 virtual bool TakeFocus(content::WebContents
* source
, bool reverse
) OVERRIDE
;
563 virtual gfx::Rect
GetRootWindowResizerRect() const OVERRIDE
;
564 virtual void BeforeUnloadFired(content::WebContents
* source
,
566 bool* proceed_to_fire_unload
) OVERRIDE
;
567 virtual bool ShouldFocusLocationBarByDefault(
568 content::WebContents
* source
) OVERRIDE
;
569 virtual void SetFocusToLocationBar(bool select_all
) OVERRIDE
;
570 virtual int GetExtraRenderViewHeight() const OVERRIDE
;
571 virtual void ViewSourceForTab(content::WebContents
* source
,
572 const GURL
& page_url
) OVERRIDE
;
573 virtual void ViewSourceForFrame(
574 content::WebContents
* source
,
575 const GURL
& frame_url
,
576 const content::PageState
& frame_page_state
) OVERRIDE
;
577 virtual void ShowRepostFormWarningDialog(
578 content::WebContents
* source
) OVERRIDE
;
579 virtual bool ShouldCreateWebContents(
580 content::WebContents
* web_contents
,
582 WindowContainerType window_container_type
,
583 const base::string16
& frame_name
,
584 const GURL
& target_url
,
585 const std::string
& partition_id
,
586 content::SessionStorageNamespace
* session_storage_namespace
) OVERRIDE
;
587 virtual void WebContentsCreated(content::WebContents
* source_contents
,
588 int64 source_frame_id
,
589 const base::string16
& frame_name
,
590 const GURL
& target_url
,
591 content::WebContents
* new_contents
) OVERRIDE
;
592 virtual void RendererUnresponsive(content::WebContents
* source
) OVERRIDE
;
593 virtual void RendererResponsive(content::WebContents
* source
) OVERRIDE
;
594 virtual void WorkerCrashed(content::WebContents
* source
) OVERRIDE
;
595 virtual void DidNavigateMainFramePostCommit(
596 content::WebContents
* web_contents
) OVERRIDE
;
597 virtual void DidNavigateToPendingEntry(
598 content::WebContents
* web_contents
) OVERRIDE
;
599 virtual content::JavaScriptDialogManager
*
600 GetJavaScriptDialogManager() OVERRIDE
;
601 virtual content::ColorChooser
* OpenColorChooser(
602 content::WebContents
* web_contents
,
604 const std::vector
<content::ColorSuggestion
>& suggestions
) OVERRIDE
;
605 virtual void RunFileChooser(
606 content::WebContents
* web_contents
,
607 const content::FileChooserParams
& params
) OVERRIDE
;
608 virtual void EnumerateDirectory(content::WebContents
* web_contents
,
610 const base::FilePath
& path
) OVERRIDE
;
611 virtual bool EmbedsFullscreenWidget() const OVERRIDE
;
612 virtual void ToggleFullscreenModeForTab(content::WebContents
* web_contents
,
613 bool enter_fullscreen
) OVERRIDE
;
614 virtual bool IsFullscreenForTabOrPending(
615 const content::WebContents
* web_contents
) const OVERRIDE
;
616 virtual void JSOutOfMemory(content::WebContents
* web_contents
) OVERRIDE
;
617 virtual void RegisterProtocolHandler(content::WebContents
* web_contents
,
618 const std::string
& protocol
,
620 const base::string16
& title
,
621 bool user_gesture
) OVERRIDE
;
622 virtual void UpdatePreferredSize(content::WebContents
* source
,
623 const gfx::Size
& pref_size
) OVERRIDE
;
624 virtual void ResizeDueToAutoResize(content::WebContents
* source
,
625 const gfx::Size
& new_size
) OVERRIDE
;
626 virtual void FindReply(content::WebContents
* web_contents
,
628 int number_of_matches
,
629 const gfx::Rect
& selection_rect
,
630 int active_match_ordinal
,
631 bool final_update
) OVERRIDE
;
632 virtual void RequestToLockMouse(content::WebContents
* web_contents
,
634 bool last_unlocked_by_target
) OVERRIDE
;
635 virtual void LostMouseLock() OVERRIDE
;
636 virtual void RequestMediaAccessPermission(
637 content::WebContents
* web_contents
,
638 const content::MediaStreamRequest
& request
,
639 const content::MediaResponseCallback
& callback
) OVERRIDE
;
640 virtual bool RequestPpapiBrokerPermission(
641 content::WebContents
* web_contents
,
643 const base::FilePath
& plugin_path
,
644 const base::Callback
<void(bool)>& callback
) OVERRIDE
;
645 virtual gfx::Size
GetSizeForNewRenderView(
646 const content::WebContents
* web_contents
) const OVERRIDE
;
648 // Overridden from CoreTabHelperDelegate:
649 // Note that the caller is responsible for deleting |old_contents|.
650 virtual void SwapTabContents(content::WebContents
* old_contents
,
651 content::WebContents
* new_contents
) OVERRIDE
;
652 virtual bool CanReloadContents(
653 content::WebContents
* web_contents
) const OVERRIDE
;
654 virtual bool CanSaveContents(
655 content::WebContents
* web_contents
) const OVERRIDE
;
657 // Overridden from SearchEngineTabHelperDelegate:
658 virtual void ConfirmAddSearchProvider(TemplateURL
* template_url
,
659 Profile
* profile
) OVERRIDE
;
661 // Overridden from WebContentsModalDialogManagerDelegate:
662 virtual void SetWebContentsBlocked(content::WebContents
* web_contents
,
663 bool blocked
) OVERRIDE
;
664 virtual web_modal::WebContentsModalDialogHost
*
665 GetWebContentsModalDialogHost() OVERRIDE
;
667 // Overridden from BookmarkTabHelperDelegate:
668 virtual void URLStarredChanged(content::WebContents
* web_contents
,
669 bool starred
) OVERRIDE
;
671 // Overridden from ZoomObserver:
672 virtual void OnZoomChanged(content::WebContents
* source
,
673 bool can_show_bubble
) OVERRIDE
;
675 // Overridden from SelectFileDialog::Listener:
676 virtual void FileSelected(const base::FilePath
& path
,
678 void* params
) OVERRIDE
;
679 virtual void FileSelectedWithExtraInfo(
680 const ui::SelectedFileInfo
& file_info
,
682 void* params
) OVERRIDE
;
684 // Overridden from content::NotificationObserver:
685 virtual void Observe(int type
,
686 const content::NotificationSource
& source
,
687 const content::NotificationDetails
& details
) OVERRIDE
;
689 // Command and state updating ///////////////////////////////////////////////
691 // Handle changes to kDevTools preference.
692 void OnDevToolsDisabledChanged();
694 // UI update coalescing and handling ////////////////////////////////////////
696 // Asks the toolbar (and as such the location bar) to update its state to
697 // reflect the current tab's current URL, security state, etc.
698 // If |should_restore_state| is true, we're switching (back?) to this tab and
699 // should restore any previous location bar state (such as user editing) as
701 void UpdateToolbar(bool should_restore_state
);
703 // Does one or both of the following for each bit in |changed_flags|:
704 // . If the update should be processed immediately, it is.
705 // . If the update should processed asynchronously (to avoid lots of ui
706 // updates), then scheduled_updates_ is updated for the |source| and update
707 // pair and a task is scheduled (assuming it isn't running already)
708 // that invokes ProcessPendingUIUpdates.
709 void ScheduleUIUpdate(const content::WebContents
* source
,
710 unsigned changed_flags
);
712 // Processes all pending updates to the UI that have been scheduled by
713 // ScheduleUIUpdate in scheduled_updates_.
714 void ProcessPendingUIUpdates();
716 // Removes all entries from scheduled_updates_ whose source is contents.
717 void RemoveScheduledUpdatesFor(content::WebContents
* contents
);
719 // Getters for UI ///////////////////////////////////////////////////////////
721 // TODO(beng): remove, and provide AutomationProvider a better way to access
722 // the LocationBarView's edit.
723 friend class AutomationProvider
;
724 friend class BrowserProxy
;
725 friend class TestingAutomationProvider
;
727 // Returns the StatusBubble from the current toolbar. It is possible for
728 // this to return NULL if called before the toolbar has initialized.
729 // TODO(beng): remove this.
730 StatusBubble
* GetStatusBubble();
732 // Session restore functions ////////////////////////////////////////////////
734 // Notifies the history database of the index for all tabs whose index is
736 void SyncHistoryWithTabs(int index
);
738 // In-progress download termination handling /////////////////////////////////
740 // Called when the window is closing to check if potential in-progress
741 // downloads should prevent it from closing.
742 // Returns true if the window can close, false otherwise.
743 bool CanCloseWithInProgressDownloads();
745 // Assorted utility functions ///////////////////////////////////////////////
747 // Sets the specified browser as the delegate of the WebContents and all the
748 // associated tab helpers that are needed.
749 void SetAsDelegate(content::WebContents
* web_contents
, Browser
* delegate
);
751 // Shows the Find Bar, optionally selecting the next entry that matches the
752 // existing search string for that Tab. |forward_direction| controls the
754 void FindInPage(bool find_next
, bool forward_direction
);
757 // TODO(beng): figure out if we need this now that the frame itself closes
758 // after a return to the message loop.
761 void TabDetachedAtImpl(content::WebContents
* contents
,
765 // Shared code between Reload() and ReloadIgnoringCache().
766 void ReloadInternal(WindowOpenDisposition disposition
, bool ignore_cache
);
768 // Depending on the disposition, return the current tab or a clone of the
770 content::WebContents
* GetOrCloneTabForDisposition(
771 WindowOpenDisposition disposition
);
773 // Implementation of SupportsWindowFeature and CanSupportWindowFeature. If
774 // |check_fullscreen| is true, the set of features reflect the actual state of
775 // the browser, otherwise the set of features reflect the possible state of
777 bool SupportsWindowFeatureImpl(WindowFeature feature
,
778 bool check_fullscreen
) const;
780 // Resets |bookmark_bar_state_| based on the active tab. Notifies the
781 // BrowserWindow if necessary.
782 void UpdateBookmarkBarState(BookmarkBarStateChangeReason reason
);
784 bool ShouldHideUIForFullscreen() const;
786 // Creates a BackgroundContents if appropriate; return true if one was
788 bool MaybeCreateBackgroundContents(
790 content::WebContents
* opener_web_contents
,
791 const base::string16
& frame_name
,
792 const GURL
& target_url
,
793 const std::string
& partition_id
,
794 content::SessionStorageNamespace
* session_storage_namespace
);
796 // Data members /////////////////////////////////////////////////////////////
798 std::vector
<InterstitialObserver
*> interstitial_observers_
;
800 content::NotificationRegistrar registrar_
;
802 PrefChangeRegistrar profile_pref_registrar_
;
804 // This Browser's type.
807 // This Browser's profile.
808 Profile
* const profile_
;
810 // This Browser's window.
811 BrowserWindow
* window_
;
813 scoped_ptr
<TabStripModelDelegate
> tab_strip_model_delegate_
;
814 scoped_ptr
<TabStripModel
> tab_strip_model_
;
816 // The application name that is also the name of the window to the shell.
817 // This name should be set when:
818 // 1) we launch an application via an application shortcut or extension API.
819 // 2) we launch an undocked devtool window.
820 std::string app_name_
;
822 // Type of app (host or child). See description of AppType.
825 // Unique identifier of this browser for session restore. This id is only
826 // unique within the current session, and is not guaranteed to be unique
828 const SessionID session_id_
;
830 // The model for the toolbar view.
831 scoped_ptr
<ToolbarModel
> toolbar_model_
;
833 // The model for the "active" search state. There are per-tab search models
834 // as well. When a tab is active its model is kept in sync with this one.
835 // When a new tab is activated its model state is propagated to this active
836 // model. This way, observers only have to attach to this single model for
837 // updates, and don't have to worry about active tab changes directly.
838 scoped_ptr
<SearchModel
> search_model_
;
840 // UI update coalescing and handling ////////////////////////////////////////
842 typedef std::map
<const content::WebContents
*, int> UpdateMap
;
844 // Maps from WebContents to pending UI updates that need to be processed.
845 // We don't update things like the URL or tab title right away to avoid
846 // flickering and extra painting.
847 // See ScheduleUIUpdate and ProcessPendingUIUpdates.
848 UpdateMap scheduled_updates_
;
850 // In-progress download termination handling /////////////////////////////////
852 enum CancelDownloadConfirmationState
{
853 NOT_PROMPTED
, // We have not asked the user.
854 WAITING_FOR_RESPONSE
, // We have asked the user and have not received a
856 RESPONSE_RECEIVED
// The user was prompted and made a decision already.
859 // State used to figure-out whether we should prompt the user for confirmation
860 // when the browser is closed with in-progress downloads.
861 CancelDownloadConfirmationState cancel_download_confirmation_state_
;
863 /////////////////////////////////////////////////////////////////////////////
865 // Override values for the bounds of the window and its maximized or minimized
867 // These are supplied by callers that don't want to use the default values.
868 // The default values are typically loaded from local state (last session),
869 // obtained from the last window of the same type, or obtained from the
870 // shell shortcut's startup info.
871 gfx::Rect override_bounds_
;
872 ui::WindowShowState initial_show_state_
;
874 // Tracks when this browser is being created by session restore.
875 bool is_session_restore_
;
877 const chrome::HostDesktopType host_desktop_type_
;
879 scoped_ptr
<chrome::UnloadController
> unload_controller_
;
880 scoped_ptr
<chrome::FastUnloadController
> fast_unload_controller_
;
882 // The Find Bar. This may be NULL if there is no Find Bar, and if it is
883 // non-NULL, it may or may not be visible.
884 scoped_ptr
<FindBarController
> find_bar_controller_
;
886 // Dialog box used for opening and saving files.
887 scoped_refptr
<ui::SelectFileDialog
> select_file_dialog_
;
889 // Keep track of the encoding auto detect pref.
890 BooleanPrefMember encoding_auto_detect_
;
892 // Helper which implements the ContentSettingBubbleModel interface.
893 scoped_ptr
<BrowserContentSettingBubbleModelDelegate
>
894 content_setting_bubble_model_delegate_
;
896 // Helper which implements the ToolbarModelDelegate interface.
897 scoped_ptr
<BrowserToolbarModelDelegate
> toolbar_model_delegate_
;
899 // A delegate that handles the details of updating the "active"
900 // |search_model_| state with the tab's state.
901 scoped_ptr
<SearchDelegate
> search_delegate_
;
903 // Helper which implements the TabRestoreServiceDelegate interface.
904 scoped_ptr
<BrowserTabRestoreServiceDelegate
> tab_restore_service_delegate_
;
906 // Helper which implements the SyncedWindowDelegate interface.
907 scoped_ptr
<BrowserSyncedWindowDelegate
> synced_window_delegate_
;
909 scoped_ptr
<BrowserInstantController
> instant_controller_
;
911 BookmarkBar::State bookmark_bar_state_
;
913 scoped_ptr
<FullscreenController
> fullscreen_controller_
;
915 scoped_ptr
<extensions::WindowController
> extension_window_controller_
;
917 scoped_ptr
<chrome::BrowserCommandController
> command_controller_
;
919 // True if the browser window has been shown at least once.
920 bool window_has_shown_
;
922 // The following factory is used for chrome update coalescing.
923 base::WeakPtrFactory
<Browser
> chrome_updater_factory_
;
925 // The following factory is used to close the frame at a later time.
926 base::WeakPtrFactory
<Browser
> weak_factory_
;
928 scoped_ptr
<BrowserLanguageStateObserver
> language_state_observer_
;
930 scoped_ptr
<chrome::ValidationMessageBubble
> validation_message_bubble_
;
932 DISALLOW_COPY_AND_ASSIGN(Browser
);
935 #endif // CHROME_BROWSER_UI_BROWSER_H_