pascal/CEF4Delphi
1
0
Fork 0
mirror of https://github.com/salvadordf/CEF4Delphi.git synced 2025-06-22 22:17:48 +02:00
Code Issues Actions 1 Releases Activity

Update to CEF 131.3.1

Browse Source
This commit is contained in:
Salvador Díaz Fau
2024-12-05 12:52:51 +01:00
parent a87256405a
commit 607f7c57fb
24 changed files with 1517 additions and 999 deletions
Download Patch File Download Diff File Expand all files Collapse all files

77
docs/html/uCEFInterfaces.html
View File

@ -141,25 +141,82 @@
</tr>
<tr class="list">
<td class="itemname">Interface&nbsp;<a class="bold" href="uCEFInterfaces.ICefFrameHandler.html"><code>ICefFrameHandler</code></a></td>
<td class="itemdesc"> Implement this interface to handle events related to ICefFrame life span. The order of callbacks is:
<td class="itemdesc">
<p>(1) During initial ICefBrowserHost creation and navigation of the main frame: - ICefFrameHandler.OnFrameCreated =&gt; The initial main frame object has been created. Any commands will be queued until the frame is attached. - ICefFrameHandler.OnMainFrameChanged =&gt; The initial main frame object has been assigned to the browser. - ICefLifeSpanHandler.OnAfterCreated =&gt; The browser is now valid and can be used. - ICefFrameHandler.OnFrameAttached =&gt; The initial main frame object is now connected to its peer in the renderer process. Commands can be routed.
<p>Implement this structure to handle events related to cef_frame_t life span. The order of callbacks is:
<p>(2) During further ICefBrowserHost navigation/loading of the main frame and/or sub-frames: - ICefFrameHandler.OnFrameCreated =&gt; A new main frame or sub-frame object has been created. Any commands will be queued until the frame is attached. - ICefFrameHandler.OnFrameAttached =&gt; A new main frame or sub-frame object is now connected to its peer in the renderer process. Commands can be routed. - ICefFrameHandler.OnFrameDetached =&gt; An existing main frame or sub- frame object has lost its connection to the renderer process. If multiple objects are detached at the same time then notifications will be sent for any sub-frame objects before the main frame object. Commands can no longer be routed and will be discarded. - ICefFrameHandler.OnMainFrameChanged =&gt; A new main frame object has been assigned to the browser. This will only occur with cross-origin navigation or re-navigation after renderer process termination (due to crashes, etc).
<p>(1) During initial cef_browser_host_t creation and navigation of the main frame:
<p>(3) During final ICefBrowserHost destruction of the main frame: - ICefFrameHandler.OnFrameDetached =&gt; Any sub-frame objects have lost their connection to the renderer process. Commands can no longer be routed and will be discarded. - ICefLifeSpanHandler.OnBeforeClose =&gt; The browser has been destroyed. - ICefFrameHandler.OnFrameDetached =&gt; The main frame object have lost its connection to the renderer process. Notifications will be sent for any sub-frame objects before the main frame object. Commands can no longer be routed and will be discarded. - ICefFrameHandler.OnMainFrameChanged =&gt; The final main frame object has been removed from the browser.
<p></p>
<p>Cross-origin navigation and/or loading receives special handling.
<pre class="preformatted">
- cef_frame_handler_t::OnFrameCreated =&gt; The initial main frame object has
been created. Any commands will be queued until the frame is attached.
- cef_frame_handler_t::OnMainFrameChanged =&gt; The initial main frame object
has been assigned to the browser.
- cef_life_span_handler_t::OnAfterCreated =&gt; The browser is now valid and
can be used.
- cef_frame_handler_t::OnFrameAttached =&gt; The initial main frame object is
now connected to its peer in the renderer process. Commands can be routed.</pre>
<p>
<p>(2) During further cef_browser_host_t navigation/loading of the main frame and/or sub-frames:
<p></p>
<pre class="preformatted">
- cef_frame_handler_t::OnFrameCreated =&gt; A new main frame or sub-frame
object has been created. Any commands will be queued until the frame is
attached.
- cef_frame_handler_t::OnFrameAttached =&gt; A new main frame or sub-frame
object is now connected to its peer in the renderer process. Commands can
be routed.
- cef_frame_handler_t::OnFrameDetached =&gt; An existing main frame or sub-
frame object has lost its connection to the renderer process. If multiple
objects are detached at the same time then notifications will be sent for
any sub-frame objects before the main frame object. Commands can no longer
be routed and will be discarded.
- CefFremeHadler::OnFrameDestroyed =&gt; An existing main frame or sub-frame
object has been destroyed.
- cef_frame_handler_t::OnMainFrameChanged =&gt; A new main frame object has
been assigned to the browser. This will only occur with cross-origin
navigation or re-navigation after renderer process termination (due to
crashes, etc).</pre>
<p>
<p>(3) During final cef_browser_host_t destruction of the main frame:
<p></p>
<pre class="preformatted">
- cef_frame_handler_t::OnFrameDetached =&gt; Any sub-frame objects have lost
their connection to the renderer process. Commands can no longer be routed
and will be discarded.
- CefFreameHandler::OnFrameDestroyed =&gt; Any sub-frame objects have been
destroyed.
- cef_life_span_handler_t::OnBeforeClose =&gt; The browser has been destroyed.
- cef_frame_handler_t::OnFrameDetached =&gt; The main frame object have lost
its connection to the renderer process. Notifications will be sent for any
sub-frame objects before the main frame object. Commands can no longer be
routed and will be discarded.
- CefFreameHandler::OnFrameDestroyed =&gt; The main frame object has been
destroyed.
- cef_frame_handler_t::OnMainFrameChanged =&gt; The final main frame object has
been removed from the browser.</pre>
<p>
<p>Special handling applies for cross-origin loading on creation/navigation of sub-frames, and cross-origin loading on creation of new popup browsers. A temporary frame will first be created in the parent frame's renderer process. This temporary frame will never attach and will be discarded after the real cross-origin frame is created in the new/target renderer process. The client will receive creation callbacks for the temporary frame, followed by cross-origin navigation callbacks (2) for the transition from the temporary frame to the real frame. The temporary frame will not receive or execute commands during this transitional period (any sent commands will be discarded).
<p>When the main frame navigates to a different origin the OnMainFrameChanged callback (2) will be executed with the old and new main frame objects.
<p>When a new sub-frame is loaded in, or an existing sub-frame is navigated to, a different origin from the parent frame, a temporary sub-frame object will first be created in the parent's renderer process. That temporary sub-frame will then be discarded after the real cross-origin sub-frame is created in the new/target renderer process. The client will receive cross-origin navigation callbacks (2) for the transition from the temporary sub-frame to the real sub-frame. The temporary sub-frame will not recieve or execute commands during this transitional period (any sent commands will be discarded).
<p>Callbacks will not be executed for placeholders that may be created during pre-commit navigation for sub-frames that do not yet exist in the renderer process. Placeholders will have cef_frame_t::get_identifier() == -4.
<p>When a new popup browser is created in a different origin from the parent browser, a temporary main frame object for the popup will first be created in the parent's renderer process. That temporary main frame will then be discarded after the real cross-origin main frame is created in the new/target renderer process. The client will recieve creation and initial navigation callbacks (1) for the temporary main frame, followed by cross- origin navigation callbacks (2) for the transition from the temporary main frame to the real main frame. The temporary main frame may receive and execute commands during this transitional period (any sent commands may be executed, but the behavior is potentially undesirable since they execute in the parent browser's renderer process and not the new/target renderer process).
<p>The functions of this structure will be called on the UI thread unless otherwise indicated.
<p>Callbacks will not be executed for placeholders that may be created during pre-commit navigation for sub-frames that do not yet exist in the renderer process. Placeholders will have ICefFrame.GetIdentifier() == -4.
<p>The functions of this interface will be called on the UI thread unless otherwise indicated. </td>
<p></td>
</tr>
<tr class="list2">
<td class="itemname">Interface&nbsp;<a class="bold" href="uCEFInterfaces.ICefCustomStreamReader.html"><code>ICefCustomStreamReader</code></a></td>