ui_click

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

Effet: exécution. É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

Clique sur un élément (via element_ref, en son centre) ou sur une coordonnée de l’écran (via coords). button left|right, count 2 = double-clic. Renvoie {clicked, at:{x,y}} — `clicked` signifie que l’événement de clic a été ENVOYÉ à ces coordonnées, PAS que l’application a réagi : CGEvent ne confirme pas la remise, de sorte qu’une application occupée, modale ou qui ignore les saisies signale exactement le même succès. Confirmez l’effet avec ui_wait_for_element ou ui_read_tree plutôt que de vous fier à `clicked`. element_disabled n’est renvoyé QUE lorsque l’application publie réellement AXEnabled=false ; un contrôle qui ne publie pas du tout AXEnabled est considéré comme inconnu et cliqué. Un élément qui ne publie aucune position (certains contrôles dans les pages web) est amené dans la zone visible par défilement ; s’il n’en a toujours pas, un simple clic gauche est effectué via son action d’appui d’accessibilité et la réponse est {clicked, via:"press_action"} sans `at` ; si cela est aussi refusé, l’erreur est no_bounds — utilisez des coords tirées d’une capture d’écran. Nécessite l’autorisation Accessibilité.

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

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": {
    "button": {
      "description": "Default left.",
      "enum": [
        "left",
        "right"
      ],
      "type": "string"
    },
    "by": {
      "description": "Default element if element_ref given, else coords.",
      "enum": [
        "element",
        "coords"
      ],
      "type": "string"
    },
    "coords": {
      "description": "{x,y} in global screen points.",
      "type": "object"
    },
    "count": {
      "description": "1 (default) or 2 for double-click.",
      "type": "integer"
    },
    "element_ref": {
      "description": "Element handle returned by ui_find_element or ui_read_tree; the click lands at that element's center. Needed when by=element, which is the default whenever element_ref is present.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour ui_click. 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.

{
  "coords": {
    "x": 100,
    "y": 100
  }
}

Windows

Objectif

Clique sur un élément (by element_ref, en son centre) ou une coordonnée d'écran (coordonnées by). bouton left|right, compte 2 = double-clic. Renvoie {clicked, at:{x,y}} — `clicked` signifie que le clic a été PUBLIÉ à ces coordonnées, PAS que l'application a agi en conséquence : SendInput ne comporte aucune confirmation de deliveryy, donc un busy ou une application modale signale le même succès. Confirmez l'effet avec ui_wait_for_element ou ui_read_tree plutôt que de faire confiance à « clicked ».

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

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 — Windows

{
  "properties": {
    "button": {
      "description": "Default left.",
      "enum": [
        "left",
        "right"
      ],
      "type": "string"
    },
    "coords": {
      "description": "{x,y} in global screen pixels.",
      "type": "object"
    },
    "count": {
      "description": "1 (default) or 2 for double-click.",
      "type": "integer"
    },
    "element_ref": {
      "description": "Element handle returned by ui_find_element or ui_read_tree; the click lands at that element's center. Pass this or coords — a non-empty element_ref wins, and coords is only read when it is absent.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Exemple documentaire

{
  "coords": {
    "x": 100,
    "y": 100
  }
}