Struct accesskit::TreeUpdate

source ·
pub struct TreeUpdate {
    pub nodes: Vec<(NodeId, Node)>,
    pub tree: Option<Tree>,
    pub focus: NodeId,
}
Expand description

A serializable representation of an atomic change to a Tree.

The sender and receiver must be in sync; the update is only meant to bring the tree from a specific previous state into its next state. Trying to apply it to the wrong tree should immediately panic.

Note that for performance, an update should only include nodes that are new or changed. AccessKit platform adapters will avoid raising extraneous events for nodes that have not changed since the previous update, but there is still a cost in processing these nodes and replacing the previous instances.

Fields§

§nodes: Vec<(NodeId, Node)>

Zero or more new or updated nodes. Order doesn’t matter.

Each node in this list will overwrite any existing node with the same ID. This means that when updating a node, fields that are unchanged from the previous version must still be set to the same values as before.

It is an error for any node in this list to not be either the root or a child of another node. For nodes other than the root, the parent must be either an unchanged node already in the tree, or another node in this list.

To add a child to the tree, the list must include both the child and an updated version of the parent with the child’s ID added to Node::children.

To remove a child and all of its descendants, this list must include an updated version of the parent node with the child’s ID removed from Node::children. Neither the child nor any of its descendants may be included in this list.

§tree: Option<Tree>

Rarely updated information about the tree as a whole. This may be omitted if it has not changed since the previous update, but providing the same information again is also allowed. This is required when initializing a tree.

§focus: NodeId

The node within this tree that has keyboard focus when the native host (e.g. window) has focus. If no specific node within the tree has keyboard focus, this must be set to the root. The latest focus state must be provided with every tree update, even if the focus state didn’t change in a given update.

Trait Implementations§

source§

impl Clone for TreeUpdate

source§

fn clone(&self) -> TreeUpdate

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for TreeUpdate

source§

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

Formats the value using the given formatter. Read more
source§

impl PartialEq for TreeUpdate

source§

fn eq(&self, other: &TreeUpdate) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

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

impl StructuralPartialEq for TreeUpdate

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> CloneToUninit for T
where T: Clone,

source§

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

source§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

source§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.