Struct SceneItemHandlerSet 

pub struct SceneItemHandlerSet {
    pub on_tap: Option<Rc<dyn Fn(&SceneTapEvent, &mut EventContext<'_>)>>,
    pub on_double_tap: Option<Rc<dyn Fn(&SceneTapEvent, &mut EventContext<'_>)>>,
    pub on_hover: Option<Rc<dyn Fn(bool, &mut EventContext<'_>)>>,
    pub on_context_menu: Option<Rc<dyn Fn(&SceneTapEvent, &mut EventContext<'_>)>>,
    pub accept_tap_buttons: ButtonMask,
    pub cursor: Option<CursorIcon>,
    pub tooltip: Option<LocalizedString>,
    pub accepts_drops: bool,
}

Per-item event closures + cursor + tooltip + drop acceptance.

Closures are stored as Rc<dyn Fn> so cloning the handler set is cheap; the SceneView clones into its dispatch path.

Fields

on_tap: Option<Rc<dyn Fn(&SceneTapEvent, &mut EventContext<'_>)>>

Tap (single click). Stored as the rich SceneTapEvent form internally; the simpler Self::on_tap setter wraps Fn(Point, ...) callers in a shim that extracts event.position_scene.

on_double_tap: Option<Rc<dyn Fn(&SceneTapEvent, &mut EventContext<'_>)>>

Double-tap. Storage only — the SceneView’s dispatch site doesn’t synthesise double-tap recognition yet; this field stays unset-on-fire until a future unit wires the recognizer in. Treat as a forward-declared slot.

on_hover: Option<Rc<dyn Fn(bool, &mut EventContext<'_>)>>

Hover transitions: bool is true on enter, false on leave.

on_context_menu: Option<Rc<dyn Fn(&SceneTapEvent, &mut EventContext<'_>)>>

Right-click / OS-native context-menu trigger.

accept_tap_buttons: ButtonMask

Which pointer buttons count as a “tap” / context-menu invocation. Default [ButtonMask::PRIMARY] for tap; the SECONDARY button always routes through on_context_menu regardless of this mask. Items wanting middle-click-as-tap extend the mask: accept_tap_buttons(PRIMARY | MIDDLE). Mirrors widget-tier accept_tap_buttons(...).

cursor: Option<CursorIcon>

Cursor icon shown while the pointer is over this item. Overrides the SceneView default.

tooltip: Option<LocalizedString>

Tooltip body for this item. Kept as a LocalizedString (not an eagerly-resolved String) so a tr!(...) source follows the active locale — the SceneView resolves it against the current locale at show time. The SceneView’s hover machinery surfaces it as a point-anchored overlay through the standard overlay manager.

accepts_drops: bool

Whether the item accepts dropped payloads.

Implementations

impl SceneItemHandlerSet

pub fn new() -> Self

An empty handler set — every closure unset, no cursor or tooltip.

pub fn on_tap<F>(&mut self, f: F) -> &mut Self

where F: Fn(Point, &mut EventContext<'_>) + 'static,

Register a tap callback. Simpler Fn(Point, &mut ctx) signature for callers that only need the click position; internally wraps in a shim that extracts event.position_scene. For modifier-aware handlers (Shift- click selection, Ctrl-click toggle, etc.) use Self::on_tap_event which exposes the full SceneTapEvent.

pub fn on_tap_event<F>(&mut self, f: F) -> &mut Self

where F: Fn(&SceneTapEvent, &mut EventContext<'_>) + 'static,

Register a tap callback that receives the full SceneTapEvent — scene-coord position, button, modifiers. Use for modifier-aware patterns (Shift+click extends selection, Ctrl+click toggles, middle-click handlers once paired with accept_tap_buttons).

pub fn on_double_tap<F>(&mut self, f: F) -> &mut Self

where F: Fn(Point, &mut EventContext<'_>) + 'static,

Register a double-tap callback (Point-only shim — see Self::on_tap). Not wired yet: the SceneView’s dispatch doesn’t recognise double-tap; the field is stored but never fired. A future unit wires the recognizer.

pub fn on_double_tap_event<F>(&mut self, f: F) -> &mut Self

where F: Fn(&SceneTapEvent, &mut EventContext<'_>) + 'static,

Rich-event variant of Self::on_double_tap.

pub fn on_hover<F>(&mut self, f: F) -> &mut Self

where F: Fn(bool, &mut EventContext<'_>) + 'static,

Register a hover callback. Receives true on enter, false on leave.

pub fn on_context_menu<F>(&mut self, f: F) -> &mut Self

where F: Fn(Point, &mut EventContext<'_>) + 'static,

Register a context-menu callback (right-click). Point-only shim; see Self::on_context_menu_event for the rich variant.

pub fn on_context_menu_event<F>(&mut self, f: F) -> &mut Self

where F: Fn(&SceneTapEvent, &mut EventContext<'_>) + 'static,

Rich-event variant of Self::on_context_menu.

pub fn accept_tap_buttons(&mut self, mask: ButtonMask) -> &mut Self

Mask of pointer buttons that should be treated as a tap for this item. Default [ButtonMask::PRIMARY]. Right-click (SECONDARY) always routes through on_context_menu regardless of this mask.

pub fn cursor(&mut self, c: CursorIcon) -> &mut Self

Override the cursor icon shown over this item.

pub fn tooltip(&mut self, t: impl Into<LocalizedString>) -> &mut Self

Set a tooltip. Accepts anything convertible into [LocalizedString] — most commonly tr!(...) for translated copy or lit!(...) for fixed text. Stored unresolved; the SceneView resolves it against the active locale when the tooltip is shown, so a tr!(...) source tracks locale changes.

pub fn accepts_drops(&mut self, accepts: bool) -> &mut Self

Mark whether the item accepts dropped payloads.

Trait Implementations

impl Clone for SceneItemHandlerSet

fn clone(&self) -> SceneItemHandlerSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SceneItemHandlerSet

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

Formats the value using the given formatter.

impl Default for SceneItemHandlerSet

fn default() -> Self

Returns the “default value” for a type.