Instance Method


Invoked to return an array of filenames that the receiver promises to create.


- (NSArray<NSString *> *)collectionView:(NSCollectionView *)collectionView namesOfPromisedFilesDroppedAtDestination:(NSURL *)dropURL forDraggedItemsAtIndexes:(NSIndexSet *)indexes;



The collection view that send the message.


The drop location where the files are created.


The indexes of the dragging items.

Return Value

An array of filenames (not full paths) for the created files that the receiver promises to create.


The delegate can support file promise drags by adding NSFilesPromisePboardType to the pasteboard in collectionView:writeItemsAtIndexes:toPasteboard:.

For more information on file promise dragging, see documentation for the NSDraggingSource protocol and namesOfPromisedFilesDroppedAtDestination:.

You do not need to implement this delegate method for your collection view to be a drag source.

See Also

Legacy Collection View Support

- collectionView:canDragItemsAtIndexes:withEvent:

Returns a Boolean indicating whether the collection view can begin dragging the specified items.

- collectionView:pasteboardWriterForItemAtIndex:

Provides the pasteboard writer for the item at the specified index

- collectionView:writeItemsAtIndexes:toPasteboard:

Invoked after it has been determined that a drag should begin, but before the drag has been started.

- collectionView:draggingImageForItemsAtIndexes:withEvent:offset:

Creates and returns a drag image to represent the specified items during a drag.

- collectionView:draggingSession:willBeginAtPoint:forItemsAtIndexes:

Notifies your delegate that a drag session is about to begin.

- collectionView:validateDrop:proposedIndex:dropOperation:

Validates the specified location to see if it is a valid drop target.

- collectionView:acceptDrop:index:dropOperation:

Invoked when the mouse is released over a collection view that previously allowed a drop.