cef/libcef_dll/ctocpp/browser_ctocpp.h
Marshall Greenblatt 241941a44a Move message routing from CefBrowser to CefFrame (see issue ).
This change moves the SendProcessMessage method from CefBrowser to CefFrame and
adds CefBrowser parameters to OnProcessMessageReceived and
OnDraggableRegionsChanged.

The internal implementation has changed as follows:
- Frame IDs are now a 64-bit combination of the 32-bit render_process_id and
  render_routing_id values that uniquely identify a RenderFrameHost (RFH).
- CefFrameHostImpl objects are now managed by CefBrowserInfo with life span tied
  to RFH expectations. Specifically, a CefFrameHostImpl object representing a
  sub-frame will be created when a RenderFrame is created in the renderer
  process and detached when the associated RenderFrame is deleted or the
  renderer process in which it runs has died.
- The CefFrameHostImpl object representing the main frame will always be valid
  but the underlying RFH (and associated frame ID) may change over time as a
  result of cross-origin navigations. Despite these changes calling LoadURL on
  the main frame object in the browser process will always navigate as expected.
- Speculative RFHs, which may be created as a result of a cross-origin
  navigation and discarded if that navigation is not committed, are now handled
  correctly (e.g. ignored in most cases until they're committed).
- It is less likely, but still possible, to receive a CefFrame object with an
  invalid frame ID (ID < 0). This can happen in cases where a RFH has not yet
  been created for a sub-frame. For example, when OnBeforeBrowse is called
  before initiating navigation in a previously nonexisting sub-frame.

To test: All tests pass with NetworkService enabled and disabled.
2019-05-29 17:44:56 +03:00

62 lines
2.1 KiB
C++

// Copyright (c) 2019 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.
//
// ---------------------------------------------------------------------------
//
// This file was generated by the CEF translator tool. If making changes by
// hand only do so within the body of existing method and function
// implementations. See the translator.README.txt file in the tools directory
// for more information.
//
// $hash=af9ed3cfda9c94f046f4f9b5c9c94b1b38ff2e64$
//
#ifndef CEF_LIBCEF_DLL_CTOCPP_BROWSER_CTOCPP_H_
#define CEF_LIBCEF_DLL_CTOCPP_BROWSER_CTOCPP_H_
#pragma once
#if !defined(WRAPPING_CEF_SHARED)
#error This file can be included wrapper-side only
#endif
#include <vector>
#include "include/capi/cef_browser_capi.h"
#include "include/capi/cef_client_capi.h"
#include "include/cef_browser.h"
#include "include/cef_client.h"
#include "libcef_dll/ctocpp/ctocpp_ref_counted.h"
// Wrap a C structure with a C++ class.
// This class may be instantiated and accessed wrapper-side only.
class CefBrowserCToCpp
: public CefCToCppRefCounted<CefBrowserCToCpp, CefBrowser, cef_browser_t> {
public:
CefBrowserCToCpp();
virtual ~CefBrowserCToCpp();
// CefBrowser methods.
CefRefPtr<CefBrowserHost> GetHost() OVERRIDE;
bool CanGoBack() OVERRIDE;
void GoBack() OVERRIDE;
bool CanGoForward() OVERRIDE;
void GoForward() OVERRIDE;
bool IsLoading() OVERRIDE;
void Reload() OVERRIDE;
void ReloadIgnoreCache() OVERRIDE;
void StopLoad() OVERRIDE;
int GetIdentifier() OVERRIDE;
bool IsSame(CefRefPtr<CefBrowser> that) OVERRIDE;
bool IsPopup() OVERRIDE;
bool HasDocument() OVERRIDE;
CefRefPtr<CefFrame> GetMainFrame() OVERRIDE;
CefRefPtr<CefFrame> GetFocusedFrame() OVERRIDE;
CefRefPtr<CefFrame> GetFrame(int64 identifier) OVERRIDE;
CefRefPtr<CefFrame> GetFrame(const CefString& name) OVERRIDE;
size_t GetFrameCount() OVERRIDE;
void GetFrameIdentifiers(std::vector<int64>& identifiers) OVERRIDE;
void GetFrameNames(std::vector<CefString>& names) OVERRIDE;
};
#endif // CEF_LIBCEF_DLL_CTOCPP_BROWSER_CTOCPP_H_