SwiftUI/MacOS: Control Cursor Appearance Two Ways
Zusammenfassung
Kurz
Der vollständige Artikel zeigt zwei Verfahren zum Ändern des Cursors in SwiftUI für macOS: `onHover` mit `NSCursor.push()`/`pop()` sowie eine eingebundene `NSView`, die Cursorrechtecke verwaltet. Er nennt Einschränkungen bei `resetCursorRects`, berichtet von einem ungeklärten Absturz beim Versuch mit `cursorUpdate` und beschreibt Preview-Probleme, die nach seiner Beobachtung im laufenden App-Betrieb nicht auftraten.
Mittel
Der vollständige Artikel erläutert zwei Wege, in macOS-Apps mit SwiftUI das Aussehen des Mauszeigers zu ändern. Der erste verwendet `onHover` und `NSCursor.push()`/`pop()`: Beim Betreten eines Bereichs wird etwa ein eigener oder ein Systemcursor gesetzt, beim Verlassen entfernt. Der zweite bindet eine `NSView` über `NSViewRepresentable` ein. Eine `NSTrackingArea` erkennt das Betreten; `resetCursorRects()` legt dort Cursorrechtecke fest, und Änderungen werden mit `invalidateCursorRects(for:)` angestoßen.
Der Autor weist darauf hin, dass Cursorrechtecke im sichtbaren Bereich liegen und `addCursorRect` nur in `resetCursorRects()` aufgerufen werden soll. Diese Methode solle man nicht direkt aufrufen. Ein Versuch, `invalidateCursorRects` aus `cursorUpdate` aufzurufen, habe einen Absturz verursacht; die Ursache sei ungeklärt. In Previews beobachtete Cursorprobleme seien beim tatsächlichen App-Lauf verschwunden, wobei die vermutete Verbindung zu Xcode nur eine Annahme des Autors ist. Ein abschließendes Beispiel zeigt diverse Systemcursor und konfigurierbare Größenänderungscursor.
Ausführlich lesen
Der vollständige Artikel von Itsuki beschreibt zwei Möglichkeiten, in einer macOS-App mit SwiftUI das Aussehen des Mauszeigers zu ändern. Es geht ausdrücklich um die Darstellung des Cursors, nicht um dessen Verhalten, etwa das Begrenzen auf ein Fenster. Der Artikel stellt die Verfahren anhand von Codebeispielen vor und zählt zusätzlich Systemcursor auf, die sich zum Ausprobieren eignen.
Der erste Ansatz verwendet SwiftUI mit `onHover` und `NSCursor.push()` beziehungsweise `NSCursor.pop()`. Beim Betreten eines Bereichs wird ein Cursor auf den Cursor-Stapel gelegt; beim Verlassen wird er wieder entfernt. Als Beispiel erzeugt der Artikel einen eigenen Cursor aus einem Systemsymbol und nennt außerdem Systemcursor wie den Zeigefinger. Für eine eigene Darstellung braucht man laut Beispiel ein Bild und einen Hotspot, der dessen Zeigerposition festlegt.
Der zweite Ansatz bindet eine eigene `NSView` über `NSViewRepresentable` in SwiftUI ein. Die View richtet eine `NSTrackingArea` für das Betreten und Verlassen ein. In `resetCursorRects()` legt sie mit `addCursorRect` den Cursor für den sichtbaren Bereich fest; bei `mouseEntered` stößt sie über `invalidateCursorRects(for:)` eine Aktualisierung an. Der Artikel betont, dass das Cursorrechteck innerhalb des sichtbaren View-Bereichs liegen soll. `addCursorRect` gehöre ausschließlich in `resetCursorRects()`, da anderweitig angelegte Rechtecke beim nächsten Neuaufbau verworfen werden könnten. `resetCursorRects()` solle man nicht direkt aufrufen, sondern stattdessen die Cursorrechtecke invalidieren. Laut Artikel muss eine überschreibende Implementierung die gewünschten Rechtecke selbst hinzufügen; ein Aufruf der Standardimplementierung sei nicht erforderlich.
Der Autor berichtet, dass der Versuch, stattdessen `cursorUpdate` zu verwenden und darin `invalidateCursorRects` aufzurufen, zum Absturz führte. Die genaue Ursache habe er nicht ermittelt. Außerdem beschreibt er ein auffälliges Verhalten in SwiftUI-Previews: Der Cursor könne nur beim Überschreiten der View-Grenze wechseln und gleich wieder zurückspringen. Nach seiner Beobachtung tritt dies beim tatsächlichen Bauen und Ausführen der App nicht auf; die Vermutung, es handle sich um ein Xcode-Problem, kennzeichnet er selbst als Annahme.
Zum Abschluss zeigt der Artikel ein Raster, mit dem verschiedene Systemcursor betrachtet und beim Darüberfahren angewendet werden können. Genannt werden unter anderem Pfeil-, Text-, Hand-, Zieh-, Größenänderungs- und Zoomcursor. Für Cursor mit Parametern, etwa `frameResize`, lassen sich Positionen und Richtungen angeben; der Autor führt nicht alle Kombinationen auf. Er merkt außerdem an, dass Java-bezogene Cursor in seiner Umgebung weder als Option erschienen noch im Quellcode sichtbar gewesen seien, ohne dafür eine Erklärung zu finden. Der Beitrag liefert damit praktische Beispiele und Hinweise zu Einschränkungen, aber keine systematische Prüfung der Lösungen über verschiedene macOS- oder Xcode-Versionen hinweg.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Die Sammelfrage enthält keine Fragen, daher bleibt die Einordnung leer. Beide Zusammenfassungen (kurz und mittel) wurden geprüft; keine enthält erfundene Angaben. Die Abgrenzung zum Verhalten des Cursors fehlt in beiden, daher das Urteil kleine Mängel.
Im Bericht, aber nicht in der Zusammenfassung
- Abgrenzung: Der Artikel behandelt nur das Erscheinungsbild des Cursors, nicht dessen Verhalten, und verweist dafür auf einen anderen Artikel zum Einsperren des Cursors
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.