ui_menu_bar_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 de la barre d'état (extra de la barre des menus / NSStatusItem, les icônes à droite de la barre des menus) et suit éventuellement un chemin de menu imbriqué. Il ne clique PAS sur les commandes de la barre des menus propre à une application (File, Edit, View…) : pour celles-ci, utilisez ui_find_element + ui_click ou ui_keystroke. Fonctionne au mieux via la barre de menu des extras AX de l'application ; les applications qui restituent des menus entièrement personnalisés (non-AX) peuvent ne pas être accessibles (revenir à ui_click aux coordonnées connues). Nécessite une autorisation d’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": {
    "app_bundle_id": {
      "description": "Owner of the status item.",
      "type": "string"
    },
    "label": {
      "description": "Status item / menu item title.",
      "type": "string"
    },
    "path": {
      "description": "Nested menu path, e.g. [\"App\",\"Settings…\"].",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [],
  "type": "object"
}

Exemple documentaire

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

{
  "label": "Local MCP",
  "path": [
    "Local MCP",
    "Settings…"
  ]
}

Windows

Objectif

Clique sur une icône de la zone de notification Windows (barre d’état système) d’après son libellé — l’équivalent d’un extra de la barre des menus. Au mieux, via UI Automation sur la barre d’état de la barre des tâches ; les apps qui dessinent une icône de zone de notification entièrement personnalisée peuvent ne pas exposer de libellé (repli sur ui_click à des coordonnées connues). Certaines icônes se trouvent dans le menu de débordement masqué, que cet outil n’ouvre pas. Sans label, il ne clique sur rien et refuse avec invalid_params.

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 (right opens the icon's context menu).",
      "enum": [
        "left",
        "right"
      ],
      "type": "string"
    },
    "label": {
      "description": "Tray icon tooltip/name to match.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Exemple documentaire

{
  "label": "Local MCP"
}