Protocol

NSDraggingDestination

The NSDraggingDestination protocol declares methods that the destination object (or recipient) of a dragged image must implement. The destination automatically receives NSDraggingDestination messages for pasteboard data types it has registered for as an image enters, moves around inside, and then exits or is released within the destination’s boundaries.

Overview

In macOS 10.7 and later NSDraggingDestination is a formal protocol with an updated interface. The OS X v10.6 behavior has been retained, but will be dropped in a future version of the operating system. The methods that are to be deprecated are marked as such.

Symbols

Managing a Dragging Session Before an Image Is Released

func draggingEntered(NSDraggingInfo)

Invoked when the dragged image enters destination bounds or frame; delegate returns dragging operation to perform.

func wantsPeriodicDraggingUpdates()

Asks the destination object whether it wants to receive periodic draggingUpdated(_:) messages.

func draggingUpdated(NSDraggingInfo)

Invoked periodically as the image is held within the destination area, allowing modification of the dragging operation or mouse-pointer position.

func draggingEnded(NSDraggingInfo?)

Implement this method to be notified when a drag operation ends in some other destination.

func draggingExited(NSDraggingInfo?)

Invoked when the dragged image exits the destination’s bounds rectangle (in the case of a view object) or its frame rectangle (in the case of a window object).

Managing a Dragging Session After an Image Is Released

func prepareForDragOperation(NSDraggingInfo)

Invoked when the image is released, allowing the receiver to agree to or refuse drag operation.

func performDragOperation(NSDraggingInfo)

Invoked after the released image has been removed from the screen, signaling the receiver to import the pasteboard data.

func concludeDragOperation(NSDraggingInfo?)

Invoked when the dragging operation is complete, signaling the receiver to perform any necessary clean-up.

Updating Dragging Images

func updateDraggingItemsForDrag(NSDraggingInfo?)

Invoked when the dragging images should be changed.

Relationships

Inherits From