hs.axuielement.observer

Таблица распространённых имён уведомлений объектов доступности, предоставленная для справки.

• Уведомления зависят от приложения и могут быть любыми строками, выбранными разработчиками приложения; этот список предоставляет рекомендуемые имена уведомлений, найденные в заголовках фреймворка macOS, но он не является исчерпывающим, и приложение или элемент не обязаны их предоставлять.

Создаёт новый объект наблюдателя для приложения с указанным идентификатором процесса.

• pid - идентификатор процесса приложения.

• новый объект observer; генерирует ошибку, если pid не существует или объект не может быть создан.

• Если у вас уже есть объект hs.application для приложения, вы можете получить его идентификатор процесса с помощью hs.application:pid()
• Если у вас уже есть объект hs.axuielement из приложения, которое вы хотите наблюдать (он не обязательно должен быть объектом приложения axuielement, а просто объектом, принадлежащим приложению), вы можете получить идентификатор процесса с помощью hs.axuielement:pid().

Регистрирует указанное уведомление для указанного элемента доступности в наблюдателе.

• element - объект hs.axuielement, представляющий элемент доступности приложения, для которого был создан наблюдатель.
• notification - строка, определяющая уведомление.

• объект observer; генерирует ошибку, если наблюдатель не может быть зарегистрирован

• несколько уведомлений для одного и того же элемента доступности могут быть зарегистрированы путём вызова этого метода несколько раз с тем же элементом, но различными строками уведомлений.
• если указанный элемент и строка уведомления уже зарегистрированы, этот метод ничего не делает.
• строка уведомления зависит от приложения и может быть любой строкой, выбранной разработчиками приложения; некоторые распространённые из них содержатся в hs.axuielement.observer.notifications, но список не исчерпывающий, и приложение или элемент не обязаны их предоставлять.

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

• fn - функция или явное nil для удаления, определяющая функцию обратного вызова, которую вызовет наблюдатель, когда назначенные элементы генерируют уведомления.

• Если аргумент предоставлен, объект observer; в противном случае текущее значение.

• обратный вызов должен ожидать 4 аргумента и не возвращать ничего. Аргументы, передаваемые в обратный вызов, будут следующими:
  • сам объект observer
  • объект hs.axuielement для элемента доступности, который сгенерировал уведомление
  • строка, определяющая конкретное уведомление, которое было получено
  • таблица, содержащая пары ключ-значение с дополнительной информацией об уведомлении, если элемент и тип уведомления её предоставляют. Обычно это будет пустая таблица, указывающая, что дополнительная информация не предоставлялась.

Возвращает true или false, указывая, наблюдает ли наблюдатель в настоящее время за уведомлениями и генерирует ли обратные вызовы.

• Нет

• булево значение, указывающее, активен ли наблюдатель в настоящее время.

Удаляет указанное уведомление для указанного элемента доступности из наблюдателя.

• element - объект hs.axuielement, представляющий элемент доступности приложения, для которого был создан наблюдатель.
• notification - строка, определяющая уведомление.

• объект observer; генерирует ошибку, если наблюдатель не может быть удален

• если указанный элемент и строка уведомления в настоящее время не зарегистрированы в наблюдателе, этот метод ничего не делает.

Начать наблюдение за приложением и вызывать обратные вызовы для назначенных элементов и уведомлений.

• Нет

• объект observer

• Этот метод ничего не делает, если наблюдатель уже запущен

Остановить наблюдение за приложением; дальнейшие обратные вызовы не будут генерироваться.

• Нет

• объект observer

• Этот метод ничего не делает, если наблюдатель в настоящее время не запущен

Возвращает таблицу уведомлений, которые в настоящее время зарегистрированы в наблюдателе.

• element - необязательный hs.axuielement для возврата списка зарегистрированных уведомлений.

• таблица, содержащая текущие зарегистрированные уведомления

• Если элемент указан, возвращаемая таблица будет содержать список строк, определяющих конкретные уведомления, за которыми наблюдатель следит для этого элемента.
• Если аргумент не указан, таблица будет содержать пары ключ-значение, где каждый ключ будет hs.axuielement, за которым ведётся наблюдение, а соответствующее значение — таблица, содержащая список строк, определяющих конкретные уведомления, за которыми наблюдатель следит для этого элемента.