Trait gio::prelude::AsyncResultExt

source ·
pub trait AsyncResultExt: IsA<AsyncResult> + Sealed + 'static {
    // Provided methods
    fn source_object(&self) -> Option<Object> { ... }
    fn legacy_propagate_error(&self) -> Result<(), Error> { ... }
}
Expand description

Trait containing all AsyncResult methods.

§Implementors

AsyncResult, Task

Provided Methods§

source

fn source_object(&self) -> Option<Object>

Gets the source object from a AsyncResult.

§Returns

a new reference to the source object for the @self, or NULL if there is none.

source

fn legacy_propagate_error(&self) -> Result<(), Error>

If @self is a Gio::SimpleAsyncResult, this is equivalent to Gio::SimpleAsyncResult::propagate_error(). Otherwise it returns FALSE.

This can be used for legacy error handling in async *_finish() wrapper functions that traditionally handled Gio::SimpleAsyncResult error returns themselves rather than calling into the virtual method. This should not be used in new code; AsyncResult errors that are set by virtual methods should also be extracted by virtual methods, to enable subclasses to chain up correctly.

§Returns

TRUE if @error is has been filled in with an error from @self, FALSE if not.

Object Safety§

This trait is not object safe.

Implementors§