ui_get_element

Pantalla, ventanas e interfaz · macOS · Windows

Efecto: lectura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Vuelve a resolver un element_ref devuelto anteriormente (sus límites/estado pueden haber cambiado). Devuelve rol, etiqueta, límites, enfoque, valor y `enabled` SOLO cuando la aplicación publica AXEnabled; ese atributo es opcional, por lo que muchos controles perfectamente utilizables lo omiten (el área de texto de TextEdit lo hace). Cuando falta, obtienes `enabled_unknown: true` en su lugar; eso es 'desconocido', NO está deshabilitado y ui_click hará clic en él. stale_element si el identificador es desconocido o el elemento ya no existe.

Entradas obligatorias

element_ref

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en inglés — macOS

{
  "properties": {
    "element_ref": {
      "type": "string"
    }
  },
  "required": [
    "element_ref"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para ui_get_element. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "element_ref": "demo-button-001"
}

Windows