Struct CefWebviewDispatcher 

pub struct CefWebviewDispatcher<T: UserEvent> { /* private fields */ }

Implementations

impl<T: UserEvent> CefWebviewDispatcher<T>

pub fn send_dev_tools_message(&self, message: &[u8]) -> Result<()>

Sends a UTF-8 encoded Chrome DevTools Protocol message to the DevTools agent.

The message’s id must come from allocate_devtools_message_id, the allocator every caller on this browser shares. A hardcoded or self-incremented id can consume another caller’s DevToolsProtocol::MethodResult. The runtime’s own requests use identifiers reserved above that allocator’s range, so they cannot be answered by a caller’s message.

pub fn on_dev_tools_protocol<F: Fn(DevToolsProtocol) + Send + Sync + 'static>( &self, f: F, ) -> Result<()>

Observes the DevToolsProtocol traffic of this browser.

The observer receives every message on the browser, including the runtime’s own requests, so results must be matched against an identifier obtained from allocate_devtools_message_id.

Scoped to this webview’s own native browser. A CEF-owned popup is a separate browser whose protocol traffic — its page content, its network activity and its dialog messages — is never reported here, the way a FrameEvent of a popup is not. Observe popups through Webview::popups, whose FrameNavigationState follows a popup’s native lifecycle without exposing what it loaded.

Trait Implementations

impl AsCefWebviewDispatcher for CefWebviewDispatcher<EventLoopMessage>

fn as_cef_webview_dispatcher( &self, ) -> Option<&CefWebviewDispatcher<EventLoopMessage>>

Returns the CEF webview dispatcher, if the runtime is CEF.

impl<T: Clone + UserEvent> Clone for CefWebviewDispatcher<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug + UserEvent> Debug for CefWebviewDispatcher<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: UserEvent> WebviewDispatch<T> for CefWebviewDispatcher<T>

type Runtime = CefRuntime<T>

The runtime this WebviewDispatch runs under.

fn run_on_main_thread<F: FnOnce() + Send + 'static>(&self, f: F) -> Result<()>

Run a task on the main thread.

fn on_webview_event<F: Fn(&WebviewEvent) + Send + 'static>( &self, f: F, ) -> WebviewEventId

Registers a webview event handler.

fn with_webview<F: FnOnce(<Self::Runtime as Runtime<T>>::Webview) + Send + 'static>( &self, f: F, ) -> Result<()>

Runs a closure with the platform webview object as argument.

fn open_devtools(&self)

Open the web inspector which is usually called devtools.

fn close_devtools(&self)

Close the web inspector which is usually called devtools.

fn is_devtools_open(&self) -> Result<bool>

Gets the devtools window’s current open state.

fn url(&self) -> Result<String>

Returns the webview’s current URL.

fn bounds(&self) -> Result<Rect>

Returns the webview’s bounds.

fn position(&self) -> Result<PhysicalPosition<i32>>

Returns the position of the top-left hand corner of the webviews’s client area relative to the top-left hand corner of the window.

fn size(&self) -> Result<PhysicalSize<u32>>

Returns the physical size of the webviews’s client area.

fn navigate(&self, url: Url) -> Result<()>

Navigate to the given URL.

fn reload(&self) -> Result<()>

Reloads the current page.

fn go_back(&self) -> Result<()>

fn can_go_back(&self) -> Result<bool>

fn go_forward(&self) -> Result<()>

fn can_go_forward(&self) -> Result<bool>

fn print(&self) -> Result<()>

Opens the dialog to prints the contents of the webview.

fn close(&self) -> Result<()>

Closes the webview.

fn set_bounds(&self, bounds: Rect) -> Result<()>

Sets the webview’s bounds.

fn set_size(&self, size: Size) -> Result<()>

Resizes the webview.

fn set_position(&self, position: Position) -> Result<()>

Updates the webview position.

fn set_focus(&self) -> Result<()>

Bring the window to front and focus the webview.

fn hide(&self) -> Result<()>

Hide the webview

fn show(&self) -> Result<()>

Show the webview

fn eval_script<S: Into<String>>(&self, script: S) -> Result<()>

Executes javascript on the window this WindowDispatch represents.

fn eval_script_with_callback<S: Into<String>>( &self, script: S, callback: impl Fn(String) + Send + 'static, ) -> Result<()>

Evaluate JavaScript with callback function on the webview this WebviewDispatch represents. The evaluation result will be serialized into a JSON string and passed to the callback function.

fn reparent(&self, window_id: WindowId) -> Result<()>

Moves the webview to the given window.

fn cookies_for_url(&self, url: Url) -> Result<Vec<Cookie<'static>>>

Get cookies for a particular url.

fn cookies(&self) -> Result<Vec<Cookie<'static>>>

Return all cookies in the cookie store.

fn set_cookie(&self, cookie: Cookie<'_>) -> Result<()>

Set a cookie for the webview.

fn delete_cookie(&self, cookie: Cookie<'_>) -> Result<()>

Delete a cookie for the webview.

fn set_auto_resize(&self, auto_resize: bool) -> Result<()>

Sets whether the webview should automatically grow and shrink its size and position when the parent window resizes.

fn set_zoom(&self, scale_factor: f64) -> Result<()>

Set the webview zoom level

fn set_background_color(&self, color: Option<Color>) -> Result<()>

Set the webview background.

fn clear_all_browsing_data(&self) -> Result<()>

Clear all browsing data for this webview.