Struct HitTester 

pub struct HitTester<Id> { /* private fields */ }

A per-frame registry of (Rect, Id) pairs, queried by pointer position to find the topmost widget under a point.

Standalone and headless – no Backend dependency, so it’s usable (and unit-testable) without a Terminal or any drawing at all, e.g. for hand-rolled hit-testing outside of Interaction.

Registrations are draw-ordered: a later push means drawn (and therefore visually on top) later, so topmost_at scans back-to-front and returns the last match. This mirrors the painter’s algorithm every widget in this crate already draws with.

Implementations

impl<Id> HitTester<Id>

pub const fn new() -> Self

An empty registry.

pub fn push(&mut self, rect: Rect, id: Id)

Register id as occupying rect, on top of everything registered so far this pass.

pub fn clear(&mut self)

Discard all registrations, e.g. at the start of a new frame’s draw pass.

pub const fn len(&self) -> usize

Number of rects currently registered.

pub const fn is_empty(&self) -> bool

true if nothing has been registered.

impl<Id: Copy> HitTester<Id>

pub fn topmost_at(&self, pos: Pos) -> Option<Id>

The id of the topmost (most recently pushed) registration whose rect contains pos, if any.

Trait Implementations

impl<Id: Clone> Clone for HitTester<Id>

fn clone(&self) -> HitTester<Id>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Id: Debug> Debug for HitTester<Id>

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

Formats the value using the given formatter.

impl<Id> Default for HitTester<Id>

fn default() -> Self

Returns the “default value” for a type.