Struct EventProxy 

pub struct EventProxy<T: Send + 'static = u64>(/* private fields */);

A thread-safe handle for injecting application-defined events into a running windowed event loop from another thread (network, audio, timer, …).

Obtained via the on_proxy callback passed to run_windowed_with_proxy/ run_app_with_proxy (payload fixed to u64, delivered as Event::Custom) or run_windowed_with_typed_proxy/run_app_with_typed_proxy (any T: Send + 'static, delivered to a caller-supplied handler), invoked synchronously right after the event loop (and this proxy) is created, before the loop starts blocking the calling thread. Clone it freely to hand a copy to each worker thread that needs to wake the loop; wraps winit’s own EventLoopProxy, which is Send + Sync for any T: Send + 'static payload.

T defaults to u64 (the payload Event::Custom itself carries), so existing code naming the bare EventProxy type (from before this type became generic) keeps compiling unchanged.

Implementations

impl<T: Send + 'static> EventProxy<T>

pub fn send_event(&self, payload: T) -> Result<(), EventProxyClosed<T>>

Injects payload into the event loop’s queue, waking it if it’s asleep.

With the default T = u64 (via run_windowed_with_proxy/run_app_with_proxy), the payload surfaces through the app’s normal poll_event/frame loop as Event::Custom(payload), like any other Event. With a custom T (via run_windowed_with_typed_proxy/run_app_with_typed_proxy), the payload is handed directly to that call’s on_custom_event handler instead: it never becomes an Event, since Event::Custom is fixed to u64.

Errors

Returns EventProxyClosed if the event loop has already exited.

Trait Implementations

impl<T: Send + 'static> Clone for EventProxy<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: Send + 'static> Debug for EventProxy<T>

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

Formats the value using the given formatter.