Vai al contenuto
Tutti gli strumenti

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

Clicca un elemento (tramite element_ref, al suo centro) o una coordinata dello schermo (tramite coords). button left|right, count 2 = doppio clic. Restituisce {clicked, at:{x,y}}: `clicked` significa che l'evento di clic è stato INVIATO a quelle coordinate, NON che l'app abbia reagito: CGEvent non conferma la consegna, quindi un'app occupata, modale o che ignora l'input riporta esattamente lo stesso successo. Verifica 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 è considerato sconosciuto e viene cliccato. A un elemento che non pubblica alcuna posizione (alcuni controlli nelle pagine web) viene chiesto di scorrere fino a diventare visibile; se continua a non averne, si esegue un singolo clic sinistro tramite la sua azione di pressione di accessibilità e la risposta è {clicked, via:"press_action"} senza `at`; se anche questo viene rifiutato, l'errore è no_bounds: usa le coordinate di uno screenshot. Richiede il permesso 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.

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": {
      "description": "Element handle returned by ui_find_element or ui_read_tree; the click lands at that element's center. Needed when by=element, which is the default whenever element_ref is present.",
      "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

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 il clic è stato PUBBLICATO a quelle coordinate, NON che l’app abbia agito di conseguenza; SendInput non fornisce alcuna conferma della consegna, quindi un’app occupata o in stato modale segnala lo stesso successo. Conferma l’effetto con ui_wait_for_element o ui_read_tree invece di fidarti di `clicked`.

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.

Schema tecnico canonico in inglese — 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": {
      "description": "Element handle returned by ui_find_element or ui_read_tree; the click lands at that element's center. Pass this or coords — a non-empty element_ref wins, and coords is only read when it is absent.",
      "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
  }
}