Cocoa in a Nutshell

Name

NSDraggingDestination — Mac OS X 10.0

Synopsis

This informal protocol declares methods for objects to implement if they need to receive dragging operations. Several of the methods of NSDraggingDestination are implemented to respond to the movement of the drag operation of an destination object, while the remainder are implemented to execute and complete the dragging operation. Completing a drag operation involves retrieving and handling the data appropriately. To retrieve the data one must first obtain the NSPasteboard object in which the data is stored, for a dragging operation only knows about this pasteboard, not the data itself. The pasteboard may be obtained with the draggingPasteboard method. This is declared by the NSDraggingInfo protocol, and all dragging operation objects conform to this protocol. See the NSDraggingInfo protocol description and NSPasteboard class description for more information.

@interface NSObject (NSDraggingDestination)

// Instance Methods

- (NSDragOperation)draggingEntered:(id <NSDraggingInfo>)sender;

- (NSDragOperation)draggingUpdated:(id <NSDraggingInfo>)sender;

- (void)draggingExited:(id <NSDraggingInfo>)sender;

- (BOOL)prepareForDragOperation:(id <NSDraggingInfo>)sender;

- (BOOL)performDragOperation:(id <NSDraggingInfo>)sender;

- (void)concludeDragOperation:(id <NSDraggingInfo>)sender;

- (void)draggingEnded:(id <NSDraggingInfo>)sender;

@end