ui_get_element

Écran, fenêtres et interface · macOS · Windows

Effet: lecture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Résout à nouveau un element_ref précédemment renvoyé (ses limites/état peuvent avoir changé). Renvoie le rôle, l'étiquette, les limites, le focus, la valeur et « enabled » ONLY lorsque l'application publie AXEnabled — cet attribut est facultatif, donc de nombreux contrôles parfaitement utilisables l'omettent (la zone de texte de TextEdit le fait). Lorsqu'il est manquant, vous obtenez à la place « enabled_unknown : true » ; c'est « inconnu », NOT désactivé et ui_click cliquera dessus. stale_element si le handle est inconnu ou si l'élément n'existe plus.

Entrées requises

element_ref

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — macOS

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

Exemple documentaire

Exemple de documentation pour ui_get_element. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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

Windows