ui_menu_bar_click

Ecrã, janelas e interface · macOS · Windows

Efeito: execução. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Clica em um item da barra de status (extra da barra de menus / NSStatusItem, os ícones à direita da barra de menus) e, opcionalmente, segue um caminho de menu aninhado. NÃO clica nos comandos da barra de menus do próprio aplicativo (Arquivo, Editar, Visualizar…): para esses, use ui_find_element + ui_click ou ui_keystroke. Melhor esforço por meio da barra de menus de extras AX do aplicativo; aplicativos que renderizam menus totalmente personalizados (não AX) podem não ser alcançáveis (recorra a ui_click em coordenadas conhecidas). Requer permissão de Acessibilidade.

Entradas obrigatórias

O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

Esquema técnico canónico em inglês — 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"
}

Exemplo documental

Exemplo de documentação para ui_menu_bar_click. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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

Windows

Finalidade

Clica em um ícone da área de notificação do Windows (bandeja do sistema) pelo rótulo — o análogo de um extra da barra de menus. Melhor esforço via UI Automation sobre a bandeja da barra de tarefas; apps que renderizam um ícone de bandeja totalmente personalizado podem não expor um rótulo (recorra a ui_click em coordenadas conhecidas). Alguns ícones ficam no menu de ícones ocultos, que isto não abre. Sem label não clica em nada e recusa com invalid_params.

Entradas obrigatórias

O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

Esquema técnico canónico em inglês — 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"
}

Exemplo documental

{
  "label": "Local MCP"
}