alignmentFeedbackTokenForMovement(in:previousPoint:alignedPoint:defaultPoint:)
Requests a feedback token for the alignment of an object requiring horizontal and vertical movement.
Declaration
func alignmentFeedbackTokenForMovement(in view: NSView?, previousPoint: NSPoint, alignedPoint: NSPoint, defaultPoint: NSPoint) -> (any NSAlignmentFeedbackToken)?Parameters
- view:
The view (Nsview) in which the object was moved.
- previousPoint:
The location (Nspoint) of the object prior to its move.
- alignedPoint:
The new location (Nspoint) of the object if alignment occurs.
- defaultPoint:
The current location (Nspoint) of the object. This is where the user actually moved the object. This location may be offset from the location of the cursor.
Return Value
A null value if the system determines that the alignment should not occur. Otherwise, a feedback token of type NSAlignmentFeedbackToken is returned.
Discussion
This method requests a feedback token for the alignment of an object requiring horizontal and vertical movement.
If a feedback token is returned, call performFeedback(_:performanceTime:) to initiate haptic feedback. Then, move the object to its aligned location.
If no feedback token is returned, don’t perform the alignment or request haptic feedback. Even if this joint horizontal and vertical alignment fails, be sure to check other alignments. For example, an individual horizontal or vertical alignment may still be allowed. If no alignments will occur, move the object to its default location.