Struct DesktopFrame 

pub struct DesktopFrame { /* private fields */ }

Cross-platform desktop frame owned by a native shell backend.

A frame owns its event registrations and command channel until the backend returns. Use the optional native runner or a custom DesktopFrameBackend; clone individual handles, not the owning frame.

Implementations

impl DesktopFrame

pub fn app_id(&self) -> Option<&str>

Borrow the immutable application identity.

pub fn runtime(&self) -> &Arc<DesktopRuntime>

Borrow the request dispatcher owned by this frame.

pub fn window(&self) -> &WindowOptions

Borrow the immutable window configuration.

pub fn shell(&self) -> &DesktopShellConfig

Borrow the immutable native shell configuration.

pub fn events(&self) -> &EventRegistry

Borrow the frame’s event registry for a custom backend.

pub fn window_handle(&self) -> &WindowHandle

Borrow the sendable window command handle.

pub fn new(runtime: Arc<DesktopRuntime>, window: WindowOptions) -> Result<Self>

Create a desktop frame with default shell options and deny-all IPC permissions.

Errors

Returns an error if the IPC schema is invalid or window styling differs from the already-rendered runtime.

pub fn on_event<F>(&self, handler: F) -> Result<(), EventRegistrationError>

where F: Fn(&DesktopEvent) -> EventResponse + Send + Sync + 'static,

Register a non-blocking callback for the frame’s lifetime.

Errors

Returns an error when registration is closed or its bounded capacity is full.

pub fn subscribe<F>( &self, handler: F, ) -> Result<EventSubscription, EventRegistrationError>

where F: Fn(&DesktopEvent) -> EventResponse + Send + Sync + 'static,

Register a callback until the returned subscription is dropped.

Errors

Returns an error when registration is closed or its bounded capacity is full.

pub fn with_app_id(self, app_id: impl Into<String>) -> Self

Set the application’s stable identity for native services.

pub fn with_shell(self, shell: DesktopShellConfig) -> Self

Attach shell options to the frame.

Trait Implementations

impl Drop for DesktopFrame

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.