SwiftUI/MacOS: Little Input For Configuring Shortcuts (HotKey)
Zusammenfassung
Kurz
Der vollständige Artikel zeigt zwei Methoden zum Erfassen konfigurierbarer macOS-Tastenkürzel und empfiehlt `NSEvent` besonders dann, wenn die Kombination später global erkannt werden soll. Der Autor nennt dabei Typumwandlungen und modifierabhängige Tastenwerte als Grenzen von SwiftUIs `onKeyPress`; das Beispiel mit lokalem Monitor filtert Modifier und lässt Sondertasten aus.
Mittel
Der vollständige Artikel vergleicht zwei Wege, Tastenkombinationen in einer macOS-App erfassen zu lassen: SwiftUIs `onKeyPress` und einen lokalen Ereignis-Monitor über `NSEvent`. Der Autor hält `onKeyPress` für einfache SwiftUI-Kurzbefehle für passend, aber für die Konfiguration globaler Tastenkürzel für weniger geeignet. Der Grund: Die Methode liefert `EventModifiers` und `KeyEquivalent`, während globale Ereignisüberwachung Modifier-Flags von `NSEvent` und den virtuellen Tastencode als `UInt16` benötigt. Zudem könne die Taste bereits durch Modifier verändert sein.
Der `NSEvent`-Ansatz speichert Modifier, Tastencode und ein Zeichen in einer vorläufigen Konfiguration, die bestätigt oder verworfen werden kann. Laut Artikel müssen die Modifier zunächst mit `deviceIndependentFlagsMask` gefiltert werden. `charactersIgnoringModifiers` soll die Grundtaste erfassen; für eine direkte Umwandlung des Tastencodes in ein Zeichen wäre etwa `UCKeyTranslate` nötig. Das gezeigte Beispiel schließt Sondertasten wie Pfeile aus. Der Artikel erläutert Code und Einschränkungen, bietet aber keinen systematischen Test oder Vergleich verschiedener macOS- und Tastatureinstellungen.
Ausführlich lesen
Der vollständige Bericht vergleicht zwei Möglichkeiten, in einer macOS-App eine vom Nutzer festgelegte Tastenkombination zu erfassen: SwiftUIs `onKeyPress(phases:action:)` und einen lokalen Ereignisbeobachter mit `NSEvent.addLocalMonitorForEvents`. Der Autor stellt die zweite Variante als geeigneter dar, wenn die gespeicherte Kombination später für globale Tastaturereignisse verwendet werden soll.
Bei `onKeyPress` braucht die Ansicht laut Artikel den Fokus. Der Handler kann Ereignisse mit `.handled` verarbeiten oder sie mit `.ignored` weiterreichen. Der Beispielcode speichert Modifier und Taste als SwiftUI-Typen (`EventModifiers` und `KeyEquivalent`) und zeigt die Kombination an. Der Autor zufolge reicht das für manche SwiftUI-Kurzbefehle aus. Für globale Ereignisüberwachung seien diese Typen jedoch unpraktisch: Benötigt würden `NSEvent.ModifierFlags` und der virtuelle Tastencode als `UInt16`. Eine manuelle Umwandlung sei mühsam. Außerdem könne `KeyEquivalent` bereits durch Modifier verändert sein; als Beispiel nennt der Artikel, dass Shift+Command+Leertaste als Command+V erscheinen könne.
Die zweite Lösung erfasst Tasten über einen lokalen `NSEvent`-Monitor, während die Konfiguration bearbeitet wird. Das Beispiel hält eine bestätigte und eine vorläufige Tastenkombination getrennt und bietet Abbrechen und Bestätigen an. Es speichert Modifier-Flags, Tastencode und zusätzlich eine Zeichenangabe. Der Monitor wird beim Bearbeiten eingerichtet und anschließend entfernt. Der Artikel nennt zwei wichtige Verarbeitungsschritte: Modifier müssen zuerst mit `deviceIndependentFlagsMask` geschnitten werden, damit die gewünschten Flags korrekt herausgelesen werden können. Für das Zeichen verwendet der Code `charactersIgnoringModifiers`; so erhält er nach Darstellung des Autors die Grundtaste ohne die meisten Modifier-Einflüsse. Eine einfache Umwandlung des Tastencodes in ein Zeichen gebe es nicht; dafür wäre etwa `UCKeyTranslate` nötig.
Das Beispiel lässt Tasten ohne gültigen Modifier sowie Sondertasten wie Pfeiltasten unberücksichtigt. Der Autor verweist für deren mögliche Unterstützung auf Apples Liste der Funktionstastenwerte. Die Empfehlung zugunsten des lokalen Monitors ist an den Anwendungsfall globaler Tastenkürzel gebunden. Der Bericht präsentiert Code und erläutert dessen Grenzen, liefert aber keinen systematischen Vergleich, keine Messergebnisse und keinen Nachweis, dass die Beispiele für alle macOS-Versionen oder Eingabekonfigurationen gleichermaßen funktionieren.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Beide Zusammenfassungen (kurz und mittel) geben den Bericht im Kern treu wieder. Da Luna weder Sammel- noch Teilfragen angegeben hat, gibt es keine Einordnung nach Skala.
Im Bericht, aber nicht in der Zusammenfassung
- Dass onKeyPress nur ausgelöst wird, solange die View den Fokus hat (daher focusable), während der NSEvent-Monitor ohne Fokus auskommt.
In der Zusammenfassung, laut Prüfung nicht im Bericht belegt
- Die Aussage, der Artikel biete keinen systematischen Test oder Vergleich verschiedener macOS- und Tastatureinstellungen, ist eine nicht belegte Bewertung und steht so nicht im Bericht.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.