Skip to main content

EventRevoker

Struct EventRevoker 

pub struct EventRevoker { /* private fields */ }
Expand description

A handle that automatically revokes an event registration when dropped.

Obtained by calling an event-registration method (e.g. Click, Closed). The registration is revoked when the EventRevoker is dropped.

To keep the event handler alive indefinitely, call forget to prevent the automatic revocation.

Call into_token to take back the raw token and prevent the automatic revocation, which is useful for interoperating with code that manages registration tokens directly.

Implementations§

§

impl EventRevoker

pub fn into_token(self) -> i64

Consumes the revoker and returns the raw registration token without revoking the event handler.

After this call the automatic revocation on drop is cancelled. The caller is responsible for passing the returned token to the corresponding Remove* method when the handler is no longer needed.

pub fn forget(self)

Consumes the revoker without revoking the event handler, keeping the handler alive indefinitely.

This is useful for “fire and forget” event registrations where the handler should outlive any particular scope.

Trait Implementations§

§

impl Drop for EventRevoker

§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

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. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.