Struct TreeItem 

pub struct TreeItem<T>
where
    T: ToText + Clone + Default + Display + Hash + PartialEq + Eq,
{ /* private fields */ }

One item inside a Tree.

Can have zero or more children.

identifier

The identifier is used to keep the state like the currently selected or opened TreeItems in the TreeState.

It needs to be unique among its siblings but can be used again on parent or child TreeItems. A common example would be a filename which has to be unique in its directory while it can exist in another.

The text can be different from its identifier. To repeat the filename analogy: File browsers sometimes hide file extensions. The filename main.rs is the identifier while it’s shown as main. Two files main.rs and main.toml can exist in the same directory and can both be displayed as main but their identifier is different.

Just like every file in a file system can be uniquely identified with its file and directory names each TreeItem in a Tree can be with these identifiers. As an example the following two identifiers describe the main file in a Rust cargo project: vec!["src", "main.rs"].

The identifier does not need to be a String and is therefore generic. Until version 0.14 this crate used usize and indices. This might still be perfect for your use case.

Example

let a = TreeItem::new_leaf("Leaf");
let b = TreeItem::new("Root", vec![a])?;

Implementations

impl<T> TreeItem<T>

where T: ToText + Clone + Default + Display + Hash + PartialEq + Eq,

pub fn new(content: T, children: Vec<Self>) -> Result<Self>

Create a new TreeItem with children.

Errors

Errors when there are duplicate identifiers in the children.

pub fn new_leaf(content: T) -> Self

Create a new TreeItem without children.

pub const fn identifier(&self) -> u64

Get a reference to the identifier.

pub const fn content(&self) -> &T

Get a reference to the text.

pub fn children(&self) -> &[Self]

pub fn child(&self, index: usize) -> Option<&Self>

Get a reference to a child by index.

pub fn child_mut(&mut self, index: usize) -> Option<&mut Self>

Get a mutable reference to a child by index.

When you choose to change the identifier the TreeState might not work as expected afterward.

pub fn height(&self) -> usize

pub fn add_child(&mut self, child: Self) -> Result<()>

Add a child to the TreeItem.

Errors

Errors when the identifier of the child already exists in the children.

Trait Implementations

impl<T> Clone for TreeItem<T>

where T: ToText + Clone + Default + Display + Hash + PartialEq + Eq + Clone,

fn clone(&self) -> TreeItem<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Debug for TreeItem<T>

where T: ToText + Clone + Default + Display + Hash + PartialEq + Eq + Debug,

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

Formats the value using the given formatter.

impl<T> PartialEq for TreeItem<T>

where T: ToText + Clone + Default + Display + Hash + PartialEq + Eq + PartialEq,

fn eq(&self, other: &TreeItem<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> Eq for TreeItem<T>

where T: ToText + Clone + Default + Display + Hash + PartialEq + Eq + Eq,

impl<T> StructuralPartialEq for TreeItem<T>

where T: ToText + Clone + Default + Display + Hash + PartialEq + Eq,