.. index:: pair: class; EE::UI::AccessibilityManager
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager:

class EE::UI::AccessibilityManager
==================================

.. toctree::
	:hidden:

	struct_EE_UI_AccessibilityManager_ChildrenCacheEntry.rst
	class_EE_UI_AccessibilityManager_ScopedDispatch.rst

Overview
~~~~~~~~

Resolves accessibility information directly from the live :ref:`UI <doxid-namespace_e_e_1_1_u_i>` tree. :ref:`More...<details-class_e_e_1_1_u_i_1_1_accessibility_manager>`


.. ref-code-block:: cpp
	:class: doxyrest-overview-code-block

	#include <accessibilitymanager.hpp>
	
	class AccessibilityManager {
	public:
		// structs
	
		struct :ref:`ChildrenCacheEntry<doxid-struct_e_e_1_1_u_i_1_1_accessibility_manager_1_1_children_cache_entry>`;

		// classes
	
		class :ref:`ScopedDispatch<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1_1_scoped_dispatch>`;

		// construction
	
		:target:`AccessibilityManager<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a4c23d5399aaeeb1f1ca6097734eba527>`(:ref:`UISceneNode<doxid-class_e_e_1_1_u_i_1_1_u_i_scene_node>`* scene);
		:target:`~AccessibilityManager<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a53b5a6092251f0c73de188ef0340b499>`();

		// methods
	
		:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` :target:`getRoot<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a3b4f6a6e3a7d9302613cbb763e565a7c>`();
		:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` :target:`getNodeRef<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a3f84659a93146c46299e0ce1639d13dc>`(:ref:`UIWidget<doxid-class_e_e_1_1_u_i_1_1_u_i_widget>`* widget);
		:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` :ref:`findNodeRef<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1aab9b830f6b36f4682b471008c7de2cd8>`(:ref:`UIWidget<doxid-class_e_e_1_1_u_i_1_1_u_i_widget>`* widget) const;
		bool :target:`isValid<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1ac3f6d318452b343848192119905238af>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref) const;
		:ref:`AccessibilityRole<doxid-namespace_e_e_1_1_u_i_1af9ed821869c9a05c6b2343fdc3fb0bb3>` :ref:`getNodeRole<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a4c7024953500272c27427391cae77d58>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref) const;
		:ref:`AccessibilityState<doxid-namespace_e_e_1_1_u_i_1ae8a4dddb4848807dfdfc02d9b8237804>` :target:`getNodeState<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1aa3813eb8979591c4e12d46e58eb27d40>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref) const;
		:ref:`AccessibilityNodeInfo<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_info>` :target:`getNodeInfo<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a3bf465f1aad4ef57cf8cffd71cee462c>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref, bool includeValue = true) const;
		:ref:`AccessibilityNodeInfo<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_info>` :ref:`getNodeInfo<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a791db01eb2857d86c049ea7f0bf5ca95>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref, bool includeValue, bool includeTextOffsets) const;
		:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` :target:`getParent<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a69309a82143234c1bed2cefac3487fad>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref);
		:ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>` :target:`getIndexInParent<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1ad912b49a834bf10c33d5422b6592a4f8>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref);
		:ref:`AccessibilityTextInfo<doxid-struct_e_e_1_1_u_i_1_1_accessibility_text_info>` :target:`getTextInfo<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1ac5db717a660e3eb86967205f311226e2>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref) const;
		:ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>` :ref:`getTextLength<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a278673529783b2f1ebd49b573e5eda76>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref) const;
		:ref:`String<doxid-class_e_e_1_1_string>` :target:`getTextRange<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a995d4f31c864c8082d9d7a8bd7ee1f80>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref, :ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>` start, :ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>` end) const;
		bool :ref:`getTextLineBounds<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1aae3c7be794dfd1d724453fc8b90d79a6>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref, :ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>` offset, :ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>`& start, :ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>`& end) const;
		:ref:`AccessibilityTextRevision<doxid-struct_e_e_1_1_u_i_1_1_accessibility_text_revision>` :target:`getTextRevision<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1ad866c6fd45f7250b6fc3e9bb182e3763>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref) const;
		void :ref:`onTextChanged<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1afcf65f89e47cc8c380a3cea5977d10bd>`(:ref:`UIWidget<doxid-class_e_e_1_1_u_i_1_1_u_i_widget>`* widget, const :ref:`Doc::DocumentContentChange<doxid-struct_e_e_1_1_u_i_1_1_doc_1_1_document_content_change>`* change);
		void :ref:`setSuppressedTextChanges<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a8274566cacca75cbc0d084d0038a1604>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref);
		size_t :target:`getChildCount<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a578b52364be3fb6fe4f4e574fcd21675>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref);
		:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` :target:`getChild<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a6058418cbdff38e2ea5e9c859ae08ba0>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref, size_t index);
		const std::vector<:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>`>& :target:`getChildren<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a51a749ff9cf56a74c88dd3c3fd00f303>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref);
		std::vector<:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>`> :target:`getSelectedChildren<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a7cf12d7bd6d922331f637f125bbda8b7>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref);
		:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` :target:`hitTest<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a31613a74d7fe012a1e797c79f678c22b>`(const :ref:`Math::Vector2f<doxid-namespace_e_e_1_1_math_1aaa8cd8ce0171a987a016e67d601f9ddb>`& screenPosition);
		:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` :target:`getKeyboardFocusedNode<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a5a35301db7550eb218d30932efd3116c>`();
		bool :target:`performAction<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1ad390048414295998450abd59375e17ef>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref, const :ref:`AccessibilityActionRequest<doxid-struct_e_e_1_1_u_i_1_1_accessibility_action_request>`& request);
		bool :target:`isBackendAvailable<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1ad88cdf7be660b8618a8639b1f3b05d7d>`() const;
		bool :target:`isBackendInitializationComplete<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a3b31249abe8c0888286a2f11cb588187>`() const;
		bool :target:`hasActiveNativeClients<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a7bca7656fe83446d61ac4db6acded1ea>`() const;
		void :ref:`onNativeClientObserved<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a5b594a9793712be233a4129e4379f921>`();
		void :ref:`onClientsDisconnected<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a91e920103c20c71f656c096b6eaf76c3>`();
		void :target:`update<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1ad28df787fc2b9001d0790cafdac8c027>`();
		void :ref:`setBackend<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a107900ee1ec1eea8bd9cad6db1454507>`(std::unique_ptr<AccessibilityBackend> backend);
		:ref:`UISceneNode<doxid-class_e_e_1_1_u_i_1_1_u_i_scene_node>`* :target:`getSceneNode<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1aeed2174d0e89165e42c472fc7f3f40ff>`() const;
		void :target:`notify<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1afcb7bc2ee3c6f1d0fdd846ef82c2695b>`(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref, :ref:`AccessibilityEvent<doxid-namespace_e_e_1_1_u_i_1a6e149b98265ee3870d7cd6ce7d313c56>` event, :ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` related = {}, :ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>` index = -1);
		const std::vector<:ref:`AccessibilityPendingEvent<doxid-struct_e_e_1_1_u_i_1_1_accessibility_pending_event>`>& :target:`getPendingEvents<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a423703c0b098ee8b2c0ada66f4212885>`() const;
		void :target:`clearPendingEvents<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1ab796ad3038c024bce4388b6eff1f4fd9>`();
		void :ref:`announce<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a525b21bbe737651a0be0f9b74b81a1fc>`(const :ref:`String<doxid-class_e_e_1_1_string>`& message, :ref:`AccessibilityLive<doxid-namespace_e_e_1_1_u_i_1abcf7468c108116aab80fd6616c185a1f>` priority = :ref:`AccessibilityLive::Polite<doxid-namespace_e_e_1_1_u_i_1abcf7468c108116aab80fd6616c185a1fa79a00d459791fcf1e9307a1195fc8938>`);
		void :ref:`onLiveRegionChanged<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a1d4ab30612ca4736b14819f0468ad0a1>`(:ref:`UIWidget<doxid-class_e_e_1_1_u_i_1_1_u_i_widget>`* widget, :ref:`AccessibilityLive<doxid-namespace_e_e_1_1_u_i_1abcf7468c108116aab80fd6616c185a1f>` priority);
		const std::vector<:ref:`AccessibilityAnnouncement<doxid-struct_e_e_1_1_u_i_1_1_accessibility_announcement>`>& :target:`getPendingAnnouncements<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a40a31ee8d29dc2e98652f5e52feca816>`() const;
		void :ref:`onRelationTargetChanged<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a3ce223b98db290de9872ab13ddc6d1b2>`(const std::string& id, const :ref:`Scene::Node<doxid-class_e_e_1_1_scene_1_1_node>`* excluded = nullptr);
		bool :ref:`isRelationTarget<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a5a4ce49681e723ad79d40f2c38abb7a4>`(:ref:`String::HashType<doxid-class_e_e_1_1_string_1a105c2ab365f2a3085c714617f129b386>` idHash) const;
		void :ref:`onRelationSubtreeChanged<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a3fa6118636717b95655d37c94907f191>`(const :ref:`Scene::Node<doxid-class_e_e_1_1_scene_1_1_node>`* subtree, bool removed);
		void :ref:`onNodeParentChange<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a17619368a865f55ab9ee09de690625af>`(:ref:`Scene::Node<doxid-class_e_e_1_1_scene_1_1_node>`* node, bool removed);
		bool :ref:`onWidgetAccessibilitySourceDelete<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a0a4f3c53da39da0425d745920aa6a000>`(:ref:`UIWidget<doxid-class_e_e_1_1_u_i_1_1_u_i_widget>`* widget);
		void :ref:`onWidgetDelete<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a048ded5993a75693a0475f5f20de1880>`(:ref:`UIWidget<doxid-class_e_e_1_1_u_i_1_1_u_i_widget>`* widget);
		void :ref:`onSubtreeRemoved<doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1aecab70769677d817a387d43ecb26686c>`(:ref:`Scene::Node<doxid-class_e_e_1_1_scene_1_1_node>`* node);
	};
.. _details-class_e_e_1_1_u_i_1_1_accessibility_manager:

Detailed Documentation
~~~~~~~~~~~~~~~~~~~~~~

Resolves accessibility information directly from the live :ref:`UI <doxid-namespace_e_e_1_1_u_i>` tree.

Methods
-------

.. index:: pair: function; findNodeRef
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1aab9b830f6b36f4682b471008c7de2cd8:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` findNodeRef(:ref:`UIWidget<doxid-class_e_e_1_1_u_i_1_1_u_i_widget>`* widget) const

The widget's identity if one was handed out, without registering one. Clients only hold handed-out identities, so property changes of other widgets need no notification.

.. index:: pair: function; getNodeRole
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a4c7024953500272c27427391cae77d58:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`AccessibilityRole<doxid-namespace_e_e_1_1_u_i_1af9ed821869c9a05c6b2343fdc3fb0bb3>` getNodeRole(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref) const

Scalar queries avoid constructing names, values, text offsets or relation caches.

.. index:: pair: function; getNodeInfo
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a791db01eb2857d86c049ea7f0bf5ca95:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`AccessibilityNodeInfo<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_info>` getNodeInfo(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref, bool includeValue, bool includeTextOffsets) const

Native metadata queries may also omit document-offset calculation.

.. index:: pair: function; getTextLength
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a278673529783b2f1ebd49b573e5eda76:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>` getTextLength(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref) const

Ranged text access in code points. Prefer these over :ref:`getNodeInfo() <doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a3bf465f1aad4ef57cf8cffd71cee462c>` 's value for text elements: they never copy more than the requested range.

.. index:: pair: function; getTextLineBounds
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1aae3c7be794dfd1d724453fc8b90d79a6:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool getTextLineBounds(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref, :ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>` offset, :ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>`& start, :ref:`Int32<doxid-namespace_e_e_1a8799799f12a84296a0119322c99c6c17>`& end) const

The line containing ``offset`` : [start, end), end past its newline.

.. index:: pair: function; onTextChanged
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1afcf65f89e47cc8c380a3cea5977d10bd:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void onTextChanged(:ref:`UIWidget<doxid-class_e_e_1_1_u_i_1_1_u_i_widget>`* widget, const :ref:`Doc::DocumentContentChange<doxid-struct_e_e_1_1_u_i_1_1_doc_1_1_document_content_change>`* change)

Reports an edit of a text widget's document, or nullptr when its whole text was replaced. Only backends requesting edit records receive them. The first few edits per widget and frame are forwarded exactly; later ones collapse into a single whole-text change, so a replace-all costs one notification.

.. index:: pair: function; setSuppressedTextChanges
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a8274566cacca75cbc0d084d0038a1604:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void setSuppressedTextChanges(:ref:`AccessibilityNodeRef<doxid-struct_e_e_1_1_u_i_1_1_accessibility_node_ref>` ref)

While set, text changes of this element are not forwarded: the caller reports them itself (AT-SPI SetTextContents sends one minimal diff). Node refs are local to this manager, so another window's element sharing the document still reports its changes. Pass an invalid ref to clear.

.. index:: pair: function; onNativeClientObserved
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a5b594a9793712be233a4129e4379f921:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void onNativeClientObserved()

Updates the scene's cached fast-path flag after an actual native accessibility query.

.. index:: pair: function; onClientsDisconnected
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a91e920103c20c71f656c096b6eaf76c3:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void onClientsDisconnected()

The scene's last client went away: releases what only clients needed, such as queried model rows and their persistent model registrations. Identities are never reused, so a reconnecting client cannot reach a stale row.

.. index:: pair: function; setBackend
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a107900ee1ec1eea8bd9cad6db1454507:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void setBackend(std::unique_ptr<AccessibilityBackend> backend)

Replaces the platform backend, which :ref:`update() <doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1ad28df787fc2b9001d0790cafdac8c027>` otherwise creates on first use. Intended for tests that observe what the manager delivers.

.. index:: pair: function; announce
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a525b21bbe737651a0be0f9b74b81a1fc:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void announce(const :ref:`String<doxid-class_e_e_1_1_string>`& message, :ref:`AccessibilityLive<doxid-namespace_e_e_1_1_u_i_1abcf7468c108116aab80fd6616c185a1f>` priority = :ref:`AccessibilityLive::Polite<doxid-namespace_e_e_1_1_u_i_1abcf7468c108116aab80fd6616c185a1fa79a00d459791fcf1e9307a1195fc8938>`)

Asks assistive clients to speak a message without moving focus. Delivered on the next :ref:`update() <doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1ad28df787fc2b9001d0790cafdac8c027>`; a no-op while no client is active.

.. index:: pair: function; onLiveRegionChanged
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a1d4ab30612ca4736b14819f0468ad0a1:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void onLiveRegionChanged(:ref:`UIWidget<doxid-class_e_e_1_1_u_i_1_1_u_i_widget>`* widget, :ref:`AccessibilityLive<doxid-namespace_e_e_1_1_u_i_1abcf7468c108116aab80fd6616c185a1f>` priority)

Queues the current text of a widget inside a live region, replacing any announcement the same widget queued earlier in this frame.

.. index:: pair: function; onRelationTargetChanged
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a3ce223b98db290de9872ab13ddc6d1b2:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void onRelationTargetChanged(const std::string& id, const :ref:`Scene::Node<doxid-class_e_e_1_1_scene_1_1_node>`* excluded = nullptr)

The widget with this id changed its name, appeared or went away. Widgets that a client read and that are named or described by it (aria-labelledby, aria-describedby) report NameChanged or DescriptionChanged. Dependents inside ``excluded`` are skipped.

.. index:: pair: function; isRelationTarget
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a5a4ce49681e723ad79d40f2c38abb7a4:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool isRelationTarget(:ref:`String::HashType<doxid-class_e_e_1_1_string_1a105c2ab365f2a3085c714617f129b386>` idHash) const

Whether an active client may hold a name or description resolved through the id with this hash, so its dependents must be told when that id goes away. Allocation-free; it matches exactly what :ref:`onRelationTargetChanged() <doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a3ce223b98db290de9872ab13ddc6d1b2>` would act on.

.. index:: pair: function; onRelationSubtreeChanged
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a3fa6118636717b95655d37c94907f191:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void onRelationSubtreeChanged(const :ref:`Scene::Node<doxid-class_e_e_1_1_scene_1_1_node>`* subtree, bool removed)

A subtree appeared or is going away: notifies the dependents of each relation target in it, except those inside the subtree when it is going away.

.. index:: pair: function; onNodeParentChange
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a17619368a865f55ab9ee09de690625af:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void onNodeParentChange(:ref:`Scene::Node<doxid-class_e_e_1_1_scene_1_1_node>`* node, bool removed)

Reports a reparent/reorder edge for the exposed roots of a widget or plain-node subtree. Removal is reported while the old parent links are intact; arrival after final relinking.

.. index:: pair: function; onWidgetAccessibilitySourceDelete
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a0a4f3c53da39da0425d745920aa6a000:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool onWidgetAccessibilitySourceDelete(:ref:`UIWidget<doxid-class_e_e_1_1_u_i_1_1_u_i_widget>`* widget)

Returns whether the widget owned a model source that has now been released.

.. index:: pair: function; onWidgetDelete
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1a048ded5993a75693a0475f5f20de1880:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void onWidgetDelete(:ref:`UIWidget<doxid-class_e_e_1_1_u_i_1_1_u_i_widget>`* widget)

Empty and native-root-only managers skip invalidation inline, without a tree walk. Explicit semantic queries can retain descendants/text indexes without a native client: those still require invalidation. Active root relations also require the full path.

.. index:: pair: function; onSubtreeRemoved
.. _doxid-class_e_e_1_1_u_i_1_1_accessibility_manager_1aecab70769677d817a387d43ecb26686c:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void onSubtreeRemoved(:ref:`Scene::Node<doxid-class_e_e_1_1_scene_1_1_node>`* node)

Invalidates registered identities before a subtree changes accessibility owners.