Alle hulpmiddelen

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 POSTED, 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

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.

Canoniek technisch schema in het EngelsmacOS
{
  "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 naar de app met focus, 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.

Vereiste invoer

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.

Canoniek technisch schema in het EngelsWindows
{
  "properties": {
    "keys": {
      "description": "e.g. ctrl+s, return, ctrl+shift+n",
      "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"
}