ui_keystroke
Bildschirm, Fenster und Oberfläche · macOS · Windows
Wirkung: Ausführen. Status: bedingt verfügbar.
„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.
macOS
Zweck
Sendet eine Tastenkombination, zum Beispiel "cmd+shift+5", "return", "cmd+," oder "escape". Modifikatoren sind cmd, shift, alt/option, ctrl und fn; das letzte Token ist die Taste. Gibt {sent, delivery:"posted_not_confirmed"} zurück. `sent` bedeutet nur, dass die Tastenereignisse gesendet wurden, nicht dass die App darauf reagiert hat: CGEvent bietet keine Zustellbestätigung und die Wirkung eines Tastendrucks lässt sich nicht allgemein zurücklesen. Prüfen Sie die Wirkung mit ui_get_element oder ui_read_tree, statt `sent` zu vertrauen. Die Modifikatoren werden nach der Kombination losgelassen, damit ein folgendes ui_type nicht verschluckt wird. unknown_key wird bei einer unbekannten Taste zurückgegeben. Erfordert die Bedienungshilfen-Berechtigung.
Erforderliche Eingaben
keys
Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.
Berechtigungen und Bestätigung
Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.
- Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.
Kanonisches technisches Schema auf Englisch — macOS
{
"properties": {
"keys": {
"description": "e.g. cmd+shift+5, return, cmd+,",
"type": "string"
}
},
"required": [
"keys"
],
"type": "object"
}Dokumentationsbeispiel
Dokumentationsbeispiel für ui_keystroke. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.
{
"keys": "escape"
}Windows
Zweck
Sendet eine Tastenkombination an die fokussierte App, zum Beispiel "ctrl+s", "ctrl+shift+n", "return", "alt+f4" oder "escape". Modifikatoren sind ctrl, shift, alt und win; cmd wird als Alias für ctrl akzeptiert. Das letzte Token ist die Taste. unknown_key wird zurückgegeben, wenn die Taste nicht erkannt wird.
Erforderliche Eingaben
keys
Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.
Berechtigungen und Bestätigung
Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.
- Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.
Kanonisches technisches Schema auf Englisch — Windows
{
"properties": {
"keys": {
"description": "e.g. ctrl+s, return, ctrl+shift+n",
"type": "string"
}
},
"required": [
"keys"
],
"type": "object"
}Dokumentationsbeispiel
Dokumentationsbeispiel für ui_keystroke. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.
{
"keys": "escape"
}