SwiftUI/MacOS: Trap Mouse Cursor in Window
Zusammenfassung
Kurz
Der Bericht erläutert, wie ein lokaler Ereignismonitor und `CGWarpMouseCursorPosition` den Mauszeiger im SwiftUI/macOS-Fenster halten können. Er erklärt das anfängliche Springen mit unterschiedlichen Koordinatensystemen und zeigt eine Randlogik mit Ausstiegsmöglichkeit; eine technische Unklarheit bei der Koordinatenumrechnung lässt der Autor offen.
Mittel
Der Bericht zeigt einen SwiftUI/macOS-Ansatz, um den Mauszeiger im App-Fenster zu halten. Dazu überwacht ein lokaler Ereignismonitor Mausbewegungen, wandelt die Position in Bildschirmkoordinaten um und setzt sie mit `CGWarpMouseCursorPosition` zurück. Das anfängliche Springen erklärt Autor Itsuki mit unterschiedlichen Koordinatenursprüngen: `NSRect` beginnt oben links, `CGRect` unten links. Eine Umrechnung der y-Koordinate anhand der Bildschirmhöhe soll das beheben.
Damit der Zeiger sich im Fenster frei bewegen kann, prüft der Beispielcode einen Innenbereich mit Abstand zu den Rändern. Beim Verlassen wird der Zeiger je nach Bewegungsrichtung an eine der acht Kanten oder Ecken gesetzt. Eine Umschaltung und Escape sollen das Begrenzen beenden. Der Autor räumt ein, nicht zu verstehen, warum eine direkte Koordinatenumrechnung in diesem Randfall nicht dasselbe Ergebnis liefert. Ereignisse mit fehlendem Fensterbezug nach dem Verlassen seien außerdem unzuverlässig. Für das Begrenzen von Ziehbewegungen müsse die Ereignismaske um etwa `.leftMouseDragged` erweitert werden.
Ausführlich lesen
Der Bericht beschreibt, wie sich der Mauszeiger in einer macOS-App mit SwiftUI innerhalb des Fensters halten lässt. Autor Itsuki nennt als möglichen Anwendungsfall etwa Spiele oder Zeichenprogramme, die fortlaufend lokale Mausereignisse benötigen: Verlässt der Zeiger das Fenster, könnten Ereignisse ausbleiben, auf die die App angewiesen ist.
Der gezeigte Grundansatz besteht darin, mit `NSEvent.addLocalMonitorForEvents` Bewegungsereignisse zu beobachten, die Zeigerposition vom Fenster- ins Bildschirmkoordinatensystem umzurechnen und den Zeiger mit `CGWarpMouseCursorPosition` zurückzusetzen. In der ersten Fassung springt der Zeiger laut Bericht jedoch und bleibt an einer festen Position. Als Ursache für das Springen erklärt der Autor die unterschiedlichen Ursprünge der Koordinatensysteme: `NSRect` hat seinen Ursprung oben links, `CGRect` unten links. Er schlägt daher vor, die y-Koordinate bei der Umwandlung anhand der Bildschirmhöhe umzurechnen.
Für freiere Bewegung prüft der nächste Ansatz, ob sich der Zeiger innerhalb eines verkleinerten Fensterbereichs befindet. Ein Abstand von 25 Punkten zu den Fensterrändern dient als Schwelle. Liegt der Zeiger innerhalb dieses Bereichs, wird er nicht zurückgesetzt. Beim Verlassen soll er an die jeweils nächstgelegene Kante oder Ecke gesetzt werden. Dazu ordnet der Beispielcode acht Bereiche um den inneren Fensterbereich den passenden Randpunkten zu und rechnet anschließend die y-Koordinate um. Der Autor merkt an, dass er nicht erklären kann, warum eine direkte Umrechnung mit der Bildschirmhöhe in diesem Fall nicht dasselbe Ergebnis liefert. Das ist eine ausdrücklich offengelassene technische Frage.
Als Einschränkung erwähnt der Bericht, dass nach dem Verlassen des Fensters noch ein oder zwei Ereignisse mit `event.window == nil` auftreten könnten; darauf zu prüfen sei jedoch nicht zuverlässig. Außerdem zeigt der abschließende Beispielcode eine Umschaltung, mit der die Begrenzung deaktiviert werden kann, sowie die Escape-Taste als Ausstiegsmöglichkeit. Der Text beschreibt dies als Bedienung über „Command + esc“, während der Code `.keyboardShortcut(.escape)` setzt. Für Anwendungen, die auch Ziehereignisse begrenzen sollen, empfiehlt der Autor, neben `.mouseMoved` beispielsweise `.leftMouseDragged` in die Ereignismaske aufzunehmen. Der Artikel präsentiert Codebeispiele und Animationen, berichtet aber keine systematische Prüfung auf unterschiedlichen Displays oder in weiteren App-Konfigurationen.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Geprüft wurde die Zusammenfassung „mittel“, da sie den Bericht am vollständigsten wiedergibt; die Zusammenfassung „kurz“ ist knapper, aber ebenfalls im Kern treu. Es wurden keine Fragen zur Einordnung angegeben, daher bleibt die Einordnung leer.
Im Bericht, aber nicht in der Zusammenfassung
- Die Motivation: Verlässt der Zeiger das Fenster, erhält die App keine lokalen Ereignisse wie touchesBegan mehr.
- Anwendungsfälle wie Spiele oder Zeichen-Apps, die das Begrenzen brauchen.
- Der erste Ansatz fixiert den Zeiger an einem festen Punkt, was der Autor ausdrücklich ablehnt.
- Der Schwellenwert (threshold) als Abstand zum Fensterrand, der den Zeiger nicht direkt an die Kante lässt.
In der Zusammenfassung, laut Prüfung nicht im Bericht belegt
- Die Formulierung „je nach Bewegungsrichtung“ ist ungenau: Im Bericht richtet sich die Zuordnung zur Kante nach der Position relativ zum Fensterrahmen, nicht nach der Bewegungsrichtung.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.