NSPasteboardItemDataProvider Protocol Reference

Conforms to
Availability
Available in OS X v10.6 and later.
Declared in
NSPasteboardItem.h
Companion guides
Related sample code

Overview

This protocol is implemented by the data provider of a pasteboard item to provide the data for a particular UTI type.

You can specify an object as a pasteboard data provider for a pasteboard item using NSPasteboardItem’s setDataProvider:forTypes: method. The data provider must implement this protocol to provide data upon request.

Tasks

Providing Data

Instance Methods

pasteboard:item:provideDataForType:

Asks the receiver to provide data for a specified type to a given pasteboard. (required)

- (void)pasteboard:(NSPasteboard *)pasteboard item:(NSPasteboardItem *)item provideDataForType:(NSString *)type
Parameters
pasteboard

A pasteboard to which the receiver has promised to provide data.

item

A pasteboard item for which the receiver has promised to provide data

type

A UTI type string.

Discussion

The receiver was previously set as the provider using setDataProvider:forTypes:.

Availability
  • Available in OS X v10.6 and later.
Declared In
NSPasteboardItem.h

pasteboardFinishedWithDataProvider:

Informs the receiver that the pasteboard no longer needs the data provider for any of its pasteboard items.

- (void)pasteboardFinishedWithDataProvider:(NSPasteboard *)pasteboard
Parameters
pasteboard

A pasteboard.

Discussion

One data provider can provide data for more than one pasteboard item. This method is called when the pasteboard no longer needs the data provider for any of its pasteboard items. This can be either because the data provider has fulfilled all promises, or because ownership of the pasteboard has changed.

Availability
  • Available in OS X v10.6 and later.
Declared In
NSPasteboardItem.h