SwiftUI/MacOS: Handle Mouse/Trackpad Events (Mouse Up, Mouse Down, Pressure Change)
Zusammenfassung
Kurz
Das vollständige Tutorial zeigt, wie sich Maus- und Trackpad-Ereignisse samt Druck über eine AppKit-`NSView` in eine SwiftUI-Zeichenfläche übertragen lassen. Der Autor zeichnet druckabhängige Kreise entlang gleichmäßig verteilter Zwischenpunkte und berichtet, dass sein rein SwiftUI-basierter Koordinatenansatz eine kleine y-Verschiebung aufwies; weitergehende Gerätetests nennt der Bericht nicht.
Mittel
Der vollständige Bericht ist ein Tutorial zum Erfassen von Maus- und Trackpad-Eingaben in einer SwiftUI/macOS-Zeichenfläche. Für Druckdaten greift der Autor auf AppKit zurück: Eine `NSView` verarbeitet `mouseDown`, `pressureChange` und `mouseUp` und wird mit `NSViewRepresentable` in SwiftUI eingebunden. Laut Artikel eignet sich `mouseDragged` nicht zur Druckmessung, weil die Druckangabe dort im beschriebenen Versuch stets 1,0 sei. `mouseDown` decke außerdem „Tap to click“ ab, während `mouseUp` das Ende einer Bewegung markiere.
Die Fensterposition wird in View-Koordinaten umgerechnet, die y-Achse für das Canvas angepasst und Punkte außerhalb der View werden verworfen. Das Zeichnen entwickelt sich von einzelnen Kreisen über verbundene Linien zu regelmäßig verteilten Zwischenpunkten. Diese werden ebenfalls als Kreise gezeichnet; ihre Größe folgt einer zwischen Start- und Endpunkt interpolierten Druckstärke. Der Autor hält Linien für ungeeignet, wenn sich die Druckstärke während eines Strichs ändert, da eine Linie nur eine Breite hat.
Ein lokaler Ereignismonitor in reinem SwiftUI wird ebenfalls gezeigt. Der Autor berichtet dabei von Problemen mit der Koordinatenumrechnung, darunter eine kleine y-Verschiebung, und bevorzugt für dieses Beispiel die `NSView`-Lösung. Der Bericht dokumentiert die Vorgehensweise und die eigenen Beobachtungen, aber keinen systematischen Test über unterschiedliche Geräte oder macOS-Versionen.
Ausführlich lesen
Der vollständige Bericht ist ein SwiftUI/macOS-Tutorial von Itsuki über den Umgang mit Maus- und Trackpad-Eingaben, einschließlich Druckänderungen. Anhand einer einfachen Zeichenfläche zeigt der Autor, wie Punkte aus Klicks und Ziehbewegungen gesammelt und auf einem SwiftUI-Canvas dargestellt werden. Für Druckinformationen verwendet das Beispiel AppKit: Ein `NSView` verarbeitet `NSEvent`-Ereignisse und wird über `NSViewRepresentable` in SwiftUI eingebunden. Für reine Positionen bei Klicks und Ziehen nennt der Bericht dagegen `onTapGesture` und `DragGesture` als SwiftUI-Möglichkeiten.
Der Artikel beschreibt `mouseDown`, `pressureChange` und `mouseUp` als zentrale Ereignisse des Beispiels. Laut Autor bildet `mouseDragged` Druckänderungen nicht zuverlässig ab: Bei seinen Drag-Ereignissen sei `event.pressure` unabhängig von der tatsächlichen Druckstärke stets 1,0. `mouseDown` sei außerdem nötig, um „Tap to click“ zu erfassen, bei dem `pressureChange` nicht ausgelöst werde. `mouseUp` dient im Beispiel dazu, das Ende des Ziehens festzustellen. Der Bericht weist darauf hin, dass der Zugriff auf `pressure` bei bestimmten anderen Ereignistypen eine `internalInconsistencyException` auslösen könne. Touch-Ereignisse empfiehlt der Autor für diesen Anwendungsfall nicht, weil ihr Verhalten von `wantsRestingTouches` abhänge und sie unter Umständen bereits beim Auflegen eines Fingers oder gar nicht ausgelöst würden.
Für die Datenübertragung wird eine `TouchPoint`-Struktur mit Position und Druckstärke eingeführt; später kommt ein Kennzeichen für Ziehpunkte hinzu. Die Position aus `locationInWindow` wird zunächst in das Koordinatensystem der `NSView` umgerechnet. Weil die Koordinaten des Canvas eine andere y-Ausrichtung haben, zieht das Beispiel den y-Wert von der View-Höhe ab. Punkte außerhalb des View-Rahmens werden laut Artikel verworfen, da Ziehereignisse auch außerhalb beginnen oder dort weiterlaufen können. Die `NSViewRepresentable` sollte in der `ZStack` über dem Canvas liegen, damit sie Eingaben erhält; alternativ könne das darüberliegende Element Hit-Tests deaktivieren. Ein eigener Kontextmenü-Handler für Rechtsklicks würde laut Autor mit dem SwiftUI-Kontextmenü konkurrieren.
Der Artikel entwickelt die Zeichnung schrittweise: Zuerst werden einzelne rote Kreise an den erfassten Positionen gezeichnet. Das bloße Setzen von Punkten ergebe bei schnellen Bewegungen eine lückenhafte Linie. Ein weiterer Versuch verbindet sie mit einer Linie; der Autor verwirft diesen Ansatz für variable Druckstärken, weil eine einzelne Linienbreite nicht zu unterschiedlich großen Anfangs- und Endpunkten passe. Seine abschließende Lösung berechnet Zwischenpunkte entlang eines Pfads und zeichnet dort jeweils Kreise. Der Abstand wird über `maxDisplacement` gesteuert. Für interpolierte Punkte wird auch der Druck zwischen Anfang und Ende fortgeschrieben; die Kreisgröße wird mit diesem Druck skaliert. Beim Mausklick setzt das Beispiel den Druck auf 1,0, bei Druckereignissen verwendet es laut Code 1,0 plus `event.pressure`.
Abschließend zeigt der Bericht einen alternativen Ansatz mit `NSEvent.addLocalMonitorForEvents` in einer SwiftUI-Ansicht. Der Autor berichtet jedoch von Schwierigkeiten bei der Umrechnung der Fensterkoordinaten: `touches(for:)` habe bei Mausereignissen einen Absturz verursacht, und seine `GeometryReader`-Lösung habe eine kleine Verschiebung auf der y-Achse gezeigt, möglicherweise durch die Titelleiste. Er empfiehlt daher für das gezeigte Zeichnungsbeispiel den `NSView`-Weg. Das sind die im Artikel beschriebenen Beobachtungen und Beispielansätze; ein allgemeiner Vergleich auf weiteren Geräten oder Systemversionen wird nicht berichtet.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Beide Kurzfassungen von Luna geben den Artikel inhaltlich korrekt wieder, lassen aber mehrere Konfliktpunkte und Designentscheidungen aus. Es gab keine Sammelfragen oder Teilfragen, daher wurde nichts eingeordnet. Die Abbildungen 7 bis 10 zeigen Überschriften fremder Beiträge und gehören nicht zum Tutorial selbst.
Im Bericht, aber nicht in der Zusammenfassung
- Touch-Events wie touchesBegan und touchesMoved wurden verworfen, weil wantsRestingTouches unbeabsichtigte Berührungen auslöst oder gar keine Ereignisse liefert.
- Ein überschriebenes rightMouseDown unterdrückt das SwiftUI-contextMenu; als Lösung wird popUpContextMenu mit einem NSMenu genannt.
- mouseDragged kann Positionen außerhalb der View melden, weshalb die Grenzprüfung nötig ist.
- Der reine SwiftUI-Ereignismonitor lässt sich nicht mit touches(for:) verbinden, weil dies bei Mausereignissen zum Absturz führt.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.