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 (by element_ref, en son centre) ou sur une coordonnée d'écran (coordonnées by). bouton left|right, compte 2 = double-clic. Renvoie {clicked, at:{x,y}} — `clicked` signifie que l'événement de clic a été PUBLIÉ à ces coordonnées, PAS que l'application a agi dessus : CGEvent ne comporte aucune confirmation de deliveryy, donc un busy, une application modale ou ignorant les entrées signale exactly le même succès. Confirmez l'effet avec ui_wait_for_element ou ui_read_tree plutôt que de faire confiance à « clicked ». element_disabled est renvoyé UNIQUEMENT lorsque l'application publie réellement AXEnabled=false ; un contrôle qui ne publie pas du tout AXEnabled est traité comme inconnu et clicked. Nécessite l’autorisation Accessibility.

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": {
      "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": {
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Exemple documentaire

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