Class

NSDraggingSession

The encapsulation of a drag-and-drop action that supports modification of the drag while in progress.

Declaration

@interface NSDraggingSession : NSObject

Overview

You start a new dragging session by calling the NSView method beginDraggingSessionWithItems:event:source: method. This method immediately returns and you can further modify the properties of the dragging session. The actual drag begins at the next turn of the run loop.

Topics

Dragging Pasteboard

draggingPasteboard

Returns the pasteboard object that contains the data being dragged.

Dragging Visual Representation

animatesToStartingPositionsOnCancelOrFail

Controls whether the dragging image animates back to its starting point on a cancelled or failed drag.

draggingFormation

Controls the dragging formation when the drag is not over the source or a valid destination.

Identifying the Dragging Session

draggingSequenceNumber

Returns a number that uniquely identifies the dragging session.

Enumerating Dragging Items

Dragging Session Location

draggingLocation

The current cursor location of the drag in screen coordinates.

Dragging Item Location

draggingLeaderIndex

The index of the dragging item under the cursor.

Relationships

Inherits From

See Also

Drag Sources

NSDraggingSource

A set of methods that are implemented by the source object in a dragging session.

NSDraggingItem

A single dragged item within a dragging session.

NSDraggingImageComponent

A single object in a dragging item.