Struct UPDATES 

pub struct UPDATES;

Update schedule service.

Implementations

impl UPDATES

pub fn sender(&self) -> AppEventSender

Create an AppEventSender that can be used to awake the app and send app events from threads outside of the app.

pub fn waker(&self, target: impl Into<Option<WidgetId>>) -> Waker

Create an std task waker that wakes the event loop and updates.

pub fn update_op( &self, op: UpdateOp, target: impl Into<Option<WidgetId>>, ) -> &UPDATES

Schedules an UpdateOp that optionally affects the target widget.

pub fn update_op_window(&self, op: UpdateOp, target: WindowId) -> &UPDATES

Schedules an UpdateOp for the window only.

pub fn update(&self, target: impl Into<Option<WidgetId>>) -> &UPDATES

Schedules an update that affects the target.

After the current update cycle ends a new update will happen that includes the target widget.

pub fn update_window(&self, target: WindowId) -> &UPDATES

Schedules an update for the window only.

pub fn update_info(&self, target: impl Into<Option<WidgetId>>) -> &UPDATES

Schedules an info rebuild that affects the target.

After the current update cycle ends a new update will happen that requests an info rebuild that includes the target widget.

pub fn update_info_window(&self, target: WindowId) -> &UPDATES

Schedules an info rebuild for the window only.

pub fn layout(&self, target: impl Into<Option<WidgetId>>) -> &UPDATES

Schedules a layout update that affects the target.

After the current update cycle ends and there are no more updates requested a layout pass is issued that includes the target widget.

pub fn layout_window(&self, target: WindowId) -> &UPDATES

Schedules a layout update for the window only.

pub fn render(&self, target: impl Into<Option<WidgetId>>) -> &UPDATES

Schedules a full render that affects the target.

After the current update cycle ends and there are no more updates or layouts requested a render pass is issued that includes the target widget.

If no target is provided only the app extensions receive a render request.

pub fn render_window(&self, target: WindowId) -> &UPDATES

Schedules a new frame for the window only.

pub fn render_update(&self, target: impl Into<Option<WidgetId>>) -> &UPDATES

Schedules a render update that affects the target.

After the current update cycle ends and there are no more updates or layouts requested a render pass is issued that includes the target widget marked for render update only. Note that if a full render was requested for another widget on the same window this request is upgraded to a full frame render.

pub fn render_update_window(&self, target: WindowId) -> &UPDATES

Schedules a render update for the window only.

pub fn is_pending_render(&self, window_id: WindowId) -> bool

Returns true is render or render update is requested for the window.

pub fn run<F>( &self, future: impl IntoFuture<Output = (), IntoFuture = F>, ) -> OnUpdateHandle

where F: Future<Output = ()> + Send + 'static,

Schedule the future to run in the app context, in the preview track of the next update.

This requests an app update. Each future awake also requests an app update and also runs in the preview track.

Returns a handle that can be dropped to cancel execution.

pub fn run_hn_once( &self, handler: Box<dyn FnMut(&UpdateArgs) -> HandlerResult + Send>, ) -> OnUpdateHandle

Schedule a handler to run once in the app context, in the preview track of the next update.

The Handler can be any kind, including async handlers. If the handler is async and does not finish in one call it is scheduled to update in preview updates.

Returns a handle that can be dropped to cancel execution.

pub fn on_pre_update( &self, handler: Box<dyn FnMut(&UpdateArgs) -> HandlerResult + Send>, ) -> OnUpdateHandle

Create a preview update handler.

The handler is called every time the app updates, just before the UI updates. It can be any of the non-async Handler, use the hn! or hn_once! macros to declare the closure. You must avoid using async handlers because UI bound async tasks cause app updates to awake, so it is very easy to lock the app in a constant sequence of updates. You can use run to start an async app context task.

Returns an OnUpdateHandle that can be used to unsubscribe, you can also unsubscribe from inside the handler by calling APP_HANDLER.unsubscribe.

pub fn on_update( &self, handler: Box<dyn FnMut(&UpdateArgs) -> HandlerResult + Send>, ) -> OnUpdateHandle

Create an update handler.

The handler is called every time the app updates, just after the UI updates. It can be any of the non-async Handler, use the hn! or hn_once! macros to declare the closure. You must avoid using async handlers because UI bound async tasks cause app updates to awake, so it is very easy to lock the app in a constant sequence of updates. You can use run to start an async app context task.

Returns an OnUpdateHandle that can be used to unsubscribe, you can also unsubscribe from inside the handler by calling APP_HANDLER.unsubscribe.