ui_keystroke

Scherm, vensters en interface · macOS · Windows

Effect: uitvoeren. Status: voorwaardelijk beschikbaar.

‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.

macOS

Doel

Verzendt een toetsencombinatie, bijvoorbeeld "cmd+shift+5", "return", "cmd+," of "escape". Modificatietoetsen: cmd, shift, alt/option, ctrl, fn. Het laatste token is de toets. Retourneert {sent, delivery:"posted_not_confirmed"} — `sent` betekent dat de toetsgebeurtenissen zijn VERSTUURD, NIET dat de app erop heeft gereageerd: CGEvent geeft geen bevestiging van aflevering en het effect van een toetsaanslag is willekeurig, dus er kan niets worden teruggelezen om dit te bewijzen. Bevestig het effect met ui_get_element / ui_read_tree in plaats van op `sent` te vertrouwen. Modificatietoetsen worden na de combinatie losgelaten, zodat een volgende ui_type niet wordt onderschept. unknown_key wordt geretourneerd als de toets niet wordt herkend. Vereist Accessibility-toestemming.

Vereiste invoer

keys

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — macOS

{
  "properties": {
    "keys": {
      "description": "e.g. cmd+shift+5, return, cmd+,",
      "type": "string"
    }
  },
  "required": [
    "keys"
  ],
  "type": "object"
}

Documentatievoorbeeld

Documentatievoorbeeld voor ui_keystroke. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

{
  "keys": "escape"
}

Windows

Doel

Verzendt een toetsencombinatie, bijvoorbeeld "ctrl+s", "ctrl+shift+n", "return", "alt+f4" of "escape". Modificatietoetsen: ctrl, shift, alt, win (cmd wordt geaccepteerd als alias voor ctrl). Het laatste token is de toets. unknown_key wordt geretourneerd als de toets niet wordt herkend. Geef element_ref mee om op een element te richten (dat krijgt eerst de focus); zonder element_ref gaan de toetsen naar de app met focus, die wordt teruggemeld in sent_to.

Vereiste invoer

keys

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

Canoniek technisch schema in het Engels — Windows

{
  "properties": {
    "element_ref": {
      "description": "Optional. Focus this element (from ui_find_element) before sending; refused with focus_failed, nothing sent, if the focus does not land in its app or its app is not the window in front; focus_lost (with sent_to and target) when another window was in front after the keys. Without it the keys go to whatever has the focus — check sent_to.",
      "type": "string"
    },
    "keys": {
      "description": "e.g. ctrl+s, return, ctrl+shift+n",
      "type": "string"
    }
  },
  "required": [
    "keys"
  ],
  "type": "object"
}

Documentatievoorbeeld

{
  "keys": "escape"
}