ui_menu_bar_click

Schermo, finestre e interfaccia · macOS · Windows

Effetto: esecuzione. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Fa clic su un elemento della barra di stato (extra della barra dei menu / NSStatusItem, le icone a destra della barra dei menu) e facoltativamente segue un percorso di menu annidato. NON fa clic sui comandi della barra dei menu propri di un'applicazione (File, Edit, View…): per quelli usa ui_find_element + ui_click oppure ui_keystroke. Funziona al meglio delle possibilità tramite la barra dei menu degli extra AX dell'app; le app che disegnano menu completamente personalizzati (non AX) potrebbero non essere raggiungibili (ripiega su ui_click a coordinate note). Richiede l'autorizzazione Accessibilità.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per ui_menu_bar_click. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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

Windows

Scopo

Clicca per etichetta un'icona dell'area di notifica di Windows (system tray), l'equivalente di un extra della barra dei menu. Al meglio delle possibilità tramite UI Automation sulla barra delle applicazioni; le app che disegnano un'icona completamente personalizzata potrebbero non esporre un'etichetta (in tal caso usa ui_click con coordinate note). Alcune icone si trovano nel riquadro nascosto dei programmi in eccesso, che questo strumento non apre. Senza label non clicca nulla e rifiuta con invalid_params.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

{
  "label": "Local MCP"
}