AccessibilityNode.invoked

Событие, вызванное, когда пользователь выполняет действие «активировать», когда фокус находится на узле доступности.

Подпишитесь на это событие, чтобы сообщить программе для чтения экрана, что узел может быть активирован, и отреагировать надлежащим образом, когда пользователь выполняет это действие. Например, активирует кнопку, переключает флажок или открывает раскрывающийся список.

Ваш обратный вызов должен активировать визуальный элемент, представленный узлом, и выполнить любые другие соответствующие задачи. Например, вы можете использовать это событие для активации управления, требующего жеста, который будет трудно выполнить пользователям программ для чтения экрана, или имеет другое значение, когда включена программа для чтения экрана.

После выполнения любых задач возвращайте соответствующее значение для указания успеха или неудачи.

На мобильных платформах действие "activate" всегда отправляет жест нажатия в центр узла AccessibilityNode.frame, что делает использование этого события необязательным. Однако, если визуальный элемент, представленный узлом, не пересекается с центром кадра узла (например, рамка узла покрывает переключатель, а также его метку), оно не получает жест нажатия. Подписка на это событие позволяет активировать элемент независимо от его положения относительно кадра узла. Примечание: Подписка на это событие не препятствует отправке жеста нажатия, поэтому убедитесь, что рамка узла не перекрывается с другими интерактивными элементами.

На Android подписка на это событие также заставляет программу чтения экрана предоставить инструкции о том, как активировать узел.

На Windows и macOS это событие необходимо для пользователей программ чтения экрана, чтобы активировать узел.

Примечание: На Windows это событие не запускается для узлов с ролью AccessibilityRole.Image.