ui_get_element
Экран, окна и интерфейс · macOS · Windows
Эффект: чтение. Статус: условно доступен.
«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.
macOS
Назначение
Повторно разрешает ранее возвращенный element_ref (его границы/состояние могли измениться). Возвращает role, label, bounds, focused, value и `enabled` ТОЛЬКО когда приложение публикует AXEnabled — этот атрибут необязателен, поэтому многие полностью работоспособные элементы его не имеют (например, текстовая область TextEdit). Если он отсутствует, возвращается `enabled_unknown: true`; это означает 'неизвестно', а НЕ 'отключено', и ui_click выполнит щелчок. stale_element, если дескриптор неизвестен или элемент больше не существует.
Обязательные входные данные
element_ref
Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.
Разрешения и подтверждение
Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.
- Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.
Каноническая техническая схема на английском — macOS
{
"properties": {
"element_ref": {
"type": "string"
}
},
"required": [
"element_ref"
],
"type": "object"
}Пример для документации
Пример документации для ui_get_element. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.
{
"element_ref": "demo-button-001"
}Windows
Назначение
Повторно разрешает ранее возвращенный element_ref (его границы/состояние могли измениться). Возвращает role, label, bounds, enabled, focused, value. stale_element, если дескриптор неизвестен или элемент больше не существует.
Обязательные входные данные
element_ref
Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.
Разрешения и подтверждение
Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.
- Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.
Каноническая техническая схема на английском — Windows
{
"properties": {
"element_ref": {
"type": "string"
}
},
"required": [
"element_ref"
],
"type": "object"
}Пример для документации
Пример документации для ui_get_element. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.
{
"element_ref": "demo-button-001"
}