Struct CustomDrawable 

pub struct CustomDrawable { /* private fields */ }

A retained visual surface whose callback records immediate drawing commands.

The same callback API is supported by browser/WebAssembly and native desktop hosts. Keep expensive drawing resources outside the callback and invalidate the drawable after retained state changes.

use fui::prelude::*;

let preview = custom_drawable(|context| {
    context.draw_circle(32.0, 32.0, 20.0, Paint::fill(rgb(0x38, 0xbd, 0xf8)));
});
preview
    .width(64.0, Unit::Pixel)
    .height(64.0, Unit::Pixel)
    .semantic_label("Drawing preview");
preview.mark_dirty();

Implementations

impl CustomDrawable

pub fn new(handler: impl Fn(&mut DrawContext) + 'static) -> Self

Creates a retained custom-drawing surface.

The runtime saves canvas state, clips to the drawable bounds, invokes handler, restores state, and flushes the command batch.

pub fn mark_dirty(&self)

Schedules a commit when visible drawing state has changed.

pub fn invalidator(&self) -> DrawableInvalidator

Returns a weak invalidator suitable for timers and readiness callbacks.

Trait Implementations

impl Clone for CustomDrawable

fn clone(&self) -> CustomDrawable

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl HasFlexBoxRoot for CustomDrawable

fn flex_box_root(&self) -> &FlexBox

impl Node for CustomDrawable

fn node_id(&self, node_id: impl Into<String>) -> &Self

where Self: Sized,

fn semantic_role(&self, role: SemanticRole) -> &Self

where Self: Sized,

fn semantic_label(&self, label: impl Into<String>) -> &Self

where Self: Sized,

fn semantic_checked(&self, state: SemanticCheckedState) -> &Self

where Self: Sized,

fn semantic_disabled(&self, disabled: bool) -> &Self

where Self: Sized,

fn clear_semantic_disabled(&self) -> &Self

where Self: Sized,

fn semantic_selected(&self, selected: bool) -> &Self

where Self: Sized,

fn clear_semantic_selected(&self) -> &Self

where Self: Sized,

fn semantic_expanded(&self, expanded: bool) -> &Self

where Self: Sized,

fn clear_semantic_expanded(&self) -> &Self

where Self: Sized,

fn semantic_value_range( &self, value_now: f32, value_min: f32, value_max: f32, ) -> &Self

where Self: Sized,

fn clear_semantic_value_range(&self) -> &Self

where Self: Sized,

fn semantic_orientation(&self, orientation: Orientation) -> &Self

where Self: Sized,

fn request_semantic_announcement(&self) -> &Self

where Self: Sized,

fn child_count(&self) -> usize

fn is_enabled(&self) -> bool

fn is_visible(&self) -> bool

fn cursor_style(&self) -> CursorStyle

fn persist_state(&self, adapter: Rc<dyn PersistedStateAdapter>) -> &Self

where Self: Sized,

fn handle(&self) -> NodeHandle

fn has_built_handle(&self) -> bool

fn on_context_menu( &self, handler: impl Fn(ContextMenuEventArgs) + 'static, ) -> &Self

where Self: Sized,

fn clear_context_menu(&self) -> &Self

where Self: Sized,

fn disable_context_menu(&self, flag: bool) -> &Self

where Self: Sized,

fn on_pointer_click( &self, handler: impl Fn(&mut PointerEventArgs) + 'static, ) -> &Self

where Self: Sized,

Handles the low-level routed pointer-click event.

fn on_pointer_double_click( &self, handler: impl Fn(&mut PointerEventArgs) + 'static, ) -> &Self

where Self: Sized,

Handles a low-level routed pointer double-click after the ordinary pointer-click callback.

fn on_pointer_triple_click( &self, handler: impl Fn(&mut PointerEventArgs) + 'static, ) -> &Self

where Self: Sized,

Handles a low-level routed pointer triple-click after the ordinary pointer-click callback.

fn on_pointer_down( &self, handler: impl Fn(&mut PointerEventArgs) + 'static, ) -> &Self

where Self: Sized,

fn on_pointer_move( &self, handler: impl Fn(&mut PointerEventArgs) + 'static, ) -> &Self

where Self: Sized,

fn on_pointer_up( &self, handler: impl Fn(&mut PointerEventArgs) + 'static, ) -> &Self

where Self: Sized,

fn on_pointer_enter( &self, handler: impl Fn(&mut PointerEventArgs) + 'static, ) -> &Self

where Self: Sized,

fn on_pointer_leave( &self, handler: impl Fn(&mut PointerEventArgs) + 'static, ) -> &Self

where Self: Sized,

fn on_pointer_cancel( &self, handler: impl Fn(&mut PointerEventArgs) + 'static, ) -> &Self

where Self: Sized,

fn on_wheel(&self, handler: impl Fn(&mut WheelEventArgs) + 'static) -> &Self

where Self: Sized,

fn on_pan_gesture( &self, handler: impl Fn(&mut GestureEventArgs) + 'static, ) -> &Self

where Self: Sized,

fn on_pinch_gesture( &self, handler: impl Fn(&mut GestureEventArgs) + 'static, ) -> &Self

where Self: Sized,

fn long_press_options( &self, minimum_duration_ms: i32, movement_tolerance: f32, ) -> &Self

where Self: Sized,

fn on_long_press( &self, handler: impl Fn(&mut LongPressEventArgs) + 'static, ) -> &Self

where Self: Sized,

fn focusable(&self, enabled: bool, tab_index: i32) -> &Self

where Self: Sized,

fn focus_now(&self) -> &Self

where Self: Sized,

fn enabled(&self, enabled: bool) -> &Self

where Self: Sized,

fn visibility(&self, visibility: Visibility) -> &Self

where Self: Sized,

fn cursor(&self, style: CursorStyle) -> &Self

where Self: Sized,

fn clear_cursor(&self) -> &Self

where Self: Sized,

fn on_key_down(&self, handler: impl Fn(&mut KeyEventArgs) + 'static) -> &Self

where Self: Sized,

fn on_key_up(&self, handler: impl Fn(&mut KeyEventArgs) + 'static) -> &Self

where Self: Sized,

fn on_focus_changed( &self, handler: impl Fn(FocusChangedEventArgs) + 'static, ) -> &Self

where Self: Sized,

fn drag_allowed_effects(&self, effects: DragDropEffects) -> &Self

where Self: Sized,

fn drag_data( &self, handler: impl Fn() -> Option<DragDataObject> + 'static, ) -> &Self

where Self: Sized,

fn clear_drag_data(&self) -> &Self

where Self: Sized,

fn allow_drop(&self, flag: bool) -> &Self

where Self: Sized,

fn on_drag_completed( &self, handler: impl Fn(DragCompletedEventArgs) + 'static, ) -> &Self

where Self: Sized,

fn on_drag_enter( &self, handler: impl Fn(DragEventArgs) -> DropProposal + 'static, ) -> &Self

where Self: Sized,

fn on_drag_over( &self, handler: impl Fn(DragEventArgs) -> DropProposal + 'static, ) -> &Self

where Self: Sized,

fn on_drag_leave(&self, handler: impl Fn(DragEventArgs) + 'static) -> &Self

where Self: Sized,

fn on_drop(&self, handler: impl Fn(DragEventArgs) + 'static) -> &Self

where Self: Sized,

fn allow_external_drop(&self, flag: bool) -> &Self

where Self: Sized,

fn on_external_drag_enter( &self, handler: impl Fn(ExternalDropEventArgs) -> DropProposal + 'static, ) -> &Self

where Self: Sized,

fn on_external_drag_over( &self, handler: impl Fn(ExternalDropEventArgs) -> DropProposal + 'static, ) -> &Self

where Self: Sized,

fn on_external_drag_leave( &self, handler: impl Fn(ExternalDropEventArgs) + 'static, ) -> &Self

where Self: Sized,

fn on_external_drop( &self, handler: impl Fn(ExternalDropEventArgs) + 'static, ) -> &Self

where Self: Sized,

fn get_bounds(&self) -> [f32; 4]

fn absolute_to_local_position( &self, absolute_x: f32, absolute_y: f32, ) -> [f32; 2]

fn local_to_absolute_position(&self, local_x: f32, local_y: f32) -> [f32; 2]

fn ensure_handle(&self)

fn build(&self)

fn dispose(&self)

fn build_children(&self)

fn append_child<T: Node>(&self, child: &T)

fn remove_child<T: Node>(&self, child: &T) -> bool

fn parent_handle(&self) -> Option<NodeHandle>

fn notify_retained_layout_mutation(&self)

fn notify_retained_mutation(&self)

fn notify_retained_child_layout_changed(&self)

fn preserve_selection_on_pointer_down(&self, preserve: bool) -> &Self

where Self: Sized,

fn tool_tip(&self, tool_tip: ToolTip) -> &Self

where Self: Sized,

fn tool_tip_text(&self, text: impl Into<String>) -> &Self

where Self: Sized,

fn clear_tool_tip(&self) -> &Self

where Self: Sized,

impl ThemeBindable for CustomDrawable

fn bind_theme(&self, handler: impl Fn(&Self, Theme) + 'static) -> &Self