Struct AnnotationRegistry 

pub struct AnnotationRegistry { /* private fields */ }

Registry that collects widget annotations during rendering.

The registry maintains a tree structure of annotated regions, enabling queries like “what widget is at position X,Y” or “find all buttons”.

Implementations

impl AnnotationRegistry

pub fn new() -> Self

Creates a new empty registry.

pub fn clear(&mut self)

Clears all registered annotations.

pub fn register(&mut self, area: Rect, annotation: Annotation) -> usize

Registers a new annotated region.

Returns the index of the registered region.

pub fn open(&mut self, area: Rect, annotation: Annotation) -> usize

Opens a region (for nested widgets).

Subsequent registrations will be children of this region.

pub fn close(&mut self)

Closes the current region.

pub fn len(&self) -> usize

Returns the number of registered regions.

pub fn is_empty(&self) -> bool

Returns true if no regions are registered.

pub fn regions(&self) -> &[RegionInfo]

Returns all registered regions.

pub fn get(&self, index: usize) -> Option<&RegionInfo>

Returns a region by index.

pub fn region_at(&self, x: u16, y: u16) -> Option<&RegionInfo>

Returns the region at the given position.

If multiple regions overlap, returns the deepest one (most specific).

pub fn regions_at(&self, x: u16, y: u16) -> Vec<&RegionInfo>

Returns all regions at the given position.

pub fn find_by_id(&self, id: &str) -> Vec<&RegionInfo>

Finds regions by annotation id.

pub fn get_by_id(&self, id: &str) -> Option<&RegionInfo>

Finds the first region with the given id.

pub fn find_by_type(&self, widget_type: &WidgetType) -> Vec<&RegionInfo>

Finds regions by widget type.

pub fn interactive_regions(&self) -> Vec<&RegionInfo>

Returns all interactive regions.

pub fn focused_region(&self) -> Option<&RegionInfo>

Returns the currently focused region, if any.

pub fn root_regions(&self) -> Vec<&RegionInfo>

Returns root regions (depth 0).

pub fn children_of(&self, index: usize) -> Vec<&RegionInfo>

Returns children of a region.

pub fn format_tree(&self) -> String

Formats the registry as a tree for debugging.

Trait Implementations

impl Clone for AnnotationRegistry

fn clone(&self) -> AnnotationRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AnnotationRegistry

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

Formats the value using the given formatter.

impl Default for AnnotationRegistry

fn default() -> AnnotationRegistry

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AnnotationRegistry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AnnotationRegistry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.