mirror of
https://bitbucket.org/chromiumembedded/cef
synced 2024-12-13 01:56:20 +01:00
38d8acfa18
The Browser object represents the top-level Chrome browser window. One or more tabs (WebContents) are then owned by the Browser object via TabStripModel. A new Browser object can be created programmatically using "new Browser" or Browser::Create, or as a result of user action such as dragging a tab out of an existing window. New or existing tabs can also be added to an already existing Browser object. The Browser object acts as the WebContentsDelegate for all attached tabs. CEF integration requires WebContentsDelegate callbacks and notification of tab attach/detach. To support this integration we add a cef::BrowserDelegate (ChromeBrowserDelegate) member that is created in the Browser constructor and receives delegation for the Browser callbacks. ChromeBrowserDelegate creates a new ChromeBrowserHostImpl when a tab is added to a Browser for the first time, and that ChromeBrowserHostImpl continues to exist until the tab's WebContents is destroyed. The associated WebContents object does not change, but the Browser object will change when the tab is dragged between windows. CEF callback logic is shared between the chrome and alloy runtimes where possible. This shared logic has been extracted from CefBrowserHostImpl to create new CefBrowserHostBase and CefBrowserContentsDelegate classes. The CefBrowserHostImpl class is now only used with the alloy runtime and will be renamed to AlloyBrowserHostImpl in a future commit.
75 lines
2.7 KiB
C++
75 lines
2.7 KiB
C++
// Copyright (c) 2015 The Chromium Embedded Framework 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 CEF_LIBCEF_BROWSER_EXTENSIONS_BROWSER_EXTENSIONS_UTIL_H_
|
|
#define CEF_LIBCEF_BROWSER_EXTENSIONS_BROWSER_EXTENSIONS_UTIL_H_
|
|
|
|
#include <vector>
|
|
|
|
#include "include/internal/cef_ptr.h"
|
|
|
|
#include "url/gurl.h"
|
|
|
|
namespace content {
|
|
class BrowserContext;
|
|
class RenderFrameHost;
|
|
class RenderViewHost;
|
|
class WebContents;
|
|
} // namespace content
|
|
|
|
class CefBrowserHostBase;
|
|
class CefBrowserHostImpl;
|
|
|
|
namespace extensions {
|
|
|
|
class Extension;
|
|
|
|
// Returns the full-page guest WebContents for the specified |owner|, if any.
|
|
content::WebContents* GetFullPageGuestForOwnerContents(
|
|
content::WebContents* owner);
|
|
|
|
// Populates |guests| with all guest WebContents with the specified |owner|.
|
|
void GetAllGuestsForOwnerContents(content::WebContents* owner,
|
|
std::vector<content::WebContents*>* guests);
|
|
|
|
// Returns the WebContents that owns the specified |guest|, if any.
|
|
content::WebContents* GetOwnerForGuestContents(content::WebContents* guest);
|
|
|
|
// Returns the CefBrowserHostBase that owns the host identified by the specified
|
|
// routing IDs, if any. |is_guest_view| will be set to true if the IDs
|
|
// match a guest view associated with the returned browser instead of the
|
|
// browser itself.
|
|
CefRefPtr<CefBrowserHostBase> GetOwnerBrowserForFrameRoute(
|
|
int render_process_id,
|
|
int render_routing_id,
|
|
bool* is_guest_view);
|
|
|
|
// Returns the CefBrowserHostBase that owns the specified |host|, if any.
|
|
// |is_guest_view| will be set to true if the host matches a guest view
|
|
// associated with the returned browser instead of the browser itself.
|
|
// TODO(cef): Delete the RVH variant once the remaining use case
|
|
// (via AlloyContentBrowserClient::OverrideWebkitPrefs) has been removed.
|
|
CefRefPtr<CefBrowserHostBase> GetOwnerBrowserForHost(
|
|
content::RenderViewHost* host,
|
|
bool* is_guest_view);
|
|
CefRefPtr<CefBrowserHostBase> GetOwnerBrowserForHost(
|
|
content::RenderFrameHost* host,
|
|
bool* is_guest_view);
|
|
|
|
// Returns the browser matching |tab_id| and |browser_context|. Returns false if
|
|
// |tab_id| is < 0 or a matching browser cannot be found within
|
|
// |browser_context|. Similar in concept to ExtensionTabUtil::GetTabById.
|
|
CefRefPtr<CefBrowserHostImpl> GetBrowserForTabId(
|
|
int tab_id,
|
|
content::BrowserContext* browser_context);
|
|
|
|
// Returns the extension associated with |url| in |profile|. Returns nullptr
|
|
// if the extension does not exist.
|
|
const Extension* GetExtensionForUrl(content::BrowserContext* browser_context,
|
|
const GURL& url);
|
|
|
|
} // namespace extensions
|
|
|
|
#endif // CEF_LIBCEF_BROWSER_EXTENSIONS_BROWSER_EXTENSIONS_UTIL_H_
|