ui_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 (tramite element_ref, al suo centro) oppure su una coordinata dello schermo (tramite coords). button left|right; count 2 = doppio clic. Restituisce {clicked, at:{x,y}}: `clicked` significa che l’evento clic è stato PUBBLICATO a quelle coordinate, NON che l’app abbia agito di conseguenza; CGEvent non fornisce alcuna conferma della consegna, quindi un’app occupata, in stato modale o che ignora l’input segnala esattamente lo stesso successo. Conferma l’effetto con ui_wait_for_element o ui_read_tree invece di fidarti di `clicked`. element_disabled viene restituito SOLO quando l’app pubblica effettivamente AXEnabled=false; un controllo che non pubblica affatto AXEnabled viene considerato di stato sconosciuto e riceve il clic. 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": {
    "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"
}

Esempio documentale

Esempio di documentazione per ui_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.

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

Windows