Enum Dispatch 

pub enum Dispatch {
    Effect {
        request_id: String,
        kind: String,
        payload: Value,
    },
    WidgetOp {
        op: String,
        payload: Value,
    },
    Window(WindowOp),
    WindowQuery(WindowQuery),
    System(SystemOp),
    SystemQuery(SystemQuery),
    Image {
        op: String,
        handle: String,
        data: Option<Vec<u8>>,
        pixels: Option<Vec<u8>>,
        width: Option<u32>,
        height: Option<u32>,
    },
}

Platform or widget operations the host must execute on Core’s behalf. Core doesn’t touch iced, stdout, or the filesystem; it produces these typed commands and the host dispatches them.

Variants

Effect

Handle a platform effect (file dialog, clipboard, notification).

Core does not execute effects; it passes the raw request through for the host to dispatch. The host decides whether to run the effect synchronously, asynchronously (via Task::perform), or return unsupported (e.g. in headless mode where file dialogs are unavailable).

Known effect kinds

Async (file dialogs): file_open, file_open_multiple, file_save, directory_select, directory_select_multiple

Sync (clipboard): clipboard_read, clipboard_write, clipboard_read_html, clipboard_write_html, clipboard_clear, clipboard_read_primary, clipboard_write_primary

Sync (notification): notification

Fields

request_id: String

kind: String

payload: Value

WidgetOp

Renderer-internal widget-targeted operation by op string.

Covers focus, scroll, cursor, pane-grid ops, tree_hash queries, list_images, load_font, announce, exit, find_focused.

Fields

op: String

payload: Value

Window(WindowOp)

Typed window operation (open, close, resize, move, …).

WindowQuery(WindowQuery)

Typed window query (get_size, get_position, …).

System(SystemOp)

Typed system-wide operation.

SystemQuery(SystemQuery)

Typed system-wide query.

Image

Image registry operation that targets a specific handle.

Known ops

create_image, update_image, delete_image. Registry-level ops without per-image fields (list, clear) re-emit as WidgetOp and share the existing handlers.

Fields

op: String

handle: String

data: Option<Vec<u8>>

pixels: Option<Vec<u8>>

width: Option<u32>

height: Option<u32>

Trait Implementations

impl Debug for Dispatch

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

Formats the value using the given formatter.