Struct WindowHandle 

pub struct WindowHandle<V> { /* private fields */ }

A handle to a window with a specific root view type. Note that this does not keep the window alive on its own.

Implementations

impl<V: 'static + Render> WindowHandle<V>

pub fn new(id: WindowId) -> Self

Creates a new handle from a window ID. This does not check if the root type of the window is V.

pub fn update<C, R>( &self, cx: &mut C, update: impl FnOnce(&mut V, &mut Window, &mut Context<'_, V>) -> R, ) -> Result<R>

where C: AppContext,

Updates the root view of this window.

This will fail if the window has been closed or if the root view’s type does not match

pub fn read<'a>(&self, cx: &'a App) -> Result<&'a V>

Read the root view out of this window.

This will fail if the window is closed or if the root view’s type does not match V.

pub fn read_with<C, R>( &self, cx: &C, read_with: impl FnOnce(&V, &App) -> R, ) -> Result<R>

where C: AppContext,

Read the root view out of this window, with a callback

This will fail if the window is closed or if the root view’s type does not match V.

pub fn entity<C>(&self, cx: &C) -> Result<Entity<V>>

where C: AppContext,

Read the root view pointer off of this window.

This will fail if the window is closed or if the root view’s type does not match V.

pub fn is_active(&self, cx: &mut App) -> Option<bool>

Check if this window is ‘active’.

Will return None if the window is closed or currently borrowed.

Methods from Deref<Target = AnyWindowHandle>

pub fn window_id(&self) -> WindowId

Get the ID of this window.

pub fn downcast<T: 'static>(&self) -> Option<WindowHandle<T>>

Attempt to convert this handle to a window handle with a specific root view type. If the types do not match, this will return None.

Trait Implementations

impl<V> Clone for WindowHandle<V>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<V> Debug for WindowHandle<V>

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

Formats the value using the given formatter.

impl<V> Deref for WindowHandle<V>

type Target = AnyWindowHandle

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<V> DerefMut for WindowHandle<V>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<V: 'static> From<WindowHandle<V>> for AnyWindowHandle

fn from(val: WindowHandle<V>) -> Self

Converts to this type from the input type.

impl<V> Hash for WindowHandle<V>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<V> PartialEq for WindowHandle<V>

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<V> Copy for WindowHandle<V>

impl<V> Eq for WindowHandle<V>