ui::AutomationEvents¶

Header: winui/ui/AutomationTree.hpp.

Receives what changed in a Window, for accessibility clients. The platform passes these changes on to screen readers, and a test can record them (ui::testing::seams(window)).

The window reports after each layout, which follows every input it handles, in this order: 1. menus that opened or closed, and the nodes whose children changed with them 1. the node automation_focus() names: a new one as focused, or the same one's changed properties 1. a change among the items around it (added, removed or renamed)

~AutomationEvents¶

virtual ~AutomationEvents() = default

listening¶

virtual bool listening() const = 0

Whether a client is listening; while false the window skips the checks.

focus_changed¶

virtual void focus_changed(Element& node) = 0

node took keyboard focus as automation sees it.

property_changed¶

virtual void property_changed(Element& node, AutomationProperty property, const AutomationValue& before, const AutomationValue& after) = 0

property of node, the node with automation focus, went from before to after.

menu_opened¶

virtual void menu_opened(Element& menu) = 0

A menu (a node with AutomationRole::Menu) opened.

menu_closed¶

virtual void menu_closed(Element& menu) = 0

A menu closed.

structure_changed¶

virtual void structure_changed(Element& node) = 0

node's automation children changed: one came, went or was renamed.