Events

On this page you'll learn about the available events and how to use them.

Basics

Events are simply callbacks which are invoked for specific actions and can, in certain circumstances, even alter the behavior of the application.

Register Callback

To register an event callback simply call the on method of your webview.
You'll need to pass the event-type as the template parameter and the callback as the function argument.

Every call to on() will return an id which can later be used to remove the same callback.

Example Callback (Resize Window)

smartview.on<saucer::window_event::resize>([](int width, int height)
{
   // ...
});

tip

If you only need an event to be called once, you can also use the once method.

Example Once Callback (Resize Window)

smartview.once<saucer::window_event::resize>([](int width, int height)
{
   // Fired once, then automatically removed.
});

Remove Callback

As previously mentioned you can unregister callbacks by saving their id.
To remove a callback, simply call remove with the event-type as the first and the id as the second argument.

Example: Callback Removal

auto id = smartview.on<saucer::window_event::resize>([](int width, int height)
{
   // ...
});

smartview.remove(saucer::window_event::resize, id);

tip

In case you simply want to remove all event callbacks of a specific event-type you can use the clear method.

Example: Clearing all Resize Callbacks

smartview.clear(saucer::window_event::resize);

Available Events

Window

Resize

Called when the Window is resized.

Signature

std::function<void(int width, int height)>

Example

smartview.on<saucer::window_event::resize>([](int width, int height)
{
    std::print("Width: {}, Height: {}\n", width, height);
});

Closed

Called when the Window is closed.

Signature

std::function<void()>

Example

smartview.on<saucer::window_event::closed>([]()
{
    std::print("WebView is closed!\n", width, height);
});

Close

Called when the Window is about to be closed.

info

Returning true from within the callback prevents the close.

Signature

std::function<bool()>

Example

smartview.on<saucer::window_event::close>([]()
{
    std::print("Preventing a close!\n", width, height);
    return true;
});

Maximize

Called when the Window is maximized or restored after being maximized.

Signature

std::function<void(bool)>

Example

smartview.on<saucer::window_event::maximize>([](bool state)
{
    std::print("WebView is maximized: {}!\n", state);
});

Minimize

Called when the Window is minimized or restored after being minimized.

Signature

std::function<void(bool)>

Example

smartview.on<saucer::window_event::minimize>([](bool state)
{
    std::print("WebView is minimized: {}!\n", state);
});

Focus

Called when the Window gains or loses focus.

Signature

std::function<void(bool)>

Example

smartview.on<saucer::window_event::focus>([](bool focus)
{
    std::print("WebView is focused: {}!\n", focus);
});

WebView

URL Changed

Called when a new URL is loaded.

Signature

std::function<void(const std::string &)>

Example

smartview.on<saucer::web_event::url_changed>([](const std::string& url)
{
    std::print("New URL loaded: {}\n", url);
});

Load Finished

Called when a webpage finished loading.

Signature

std::function<void()>

Example

smartview.on<saucer::web_event::load_finished>([]()
{
    std::print("Web-Page finished loading!\n");
});

Load Started

Called when a webpage starts loading.

Signature

std::function<void()>

Example

smartview.on<saucer::web_event::load_started>([]()
{
    std::print("Web-Page started loading!\n");
});

DOM Ready

Called when the DOM Content loaded.

Signature

std::function<void()>

Example

smartview.on<saucer::web_event::dom_ready>([]()
{
    std::print("DOM is ready!\n");
});