Instance Method

stringForType:

Returns a concatenation of the strings for the specified type from all the items in the receiver that contain the type.

Declaration

- (NSString *)stringForType:(NSPasteboardType)dataType;

Parameters

dataType

The pasteboard data type to read.

Return Value

A concatenation of the strings for the specified type from all the items in the receiver that contain the type, or nil if none of the items contain strings of the specified type.

Discussion

This method invokes dataForType: to obtain the string. If the string cannot be obtained, stringForType: returns nil. See dataForType: for a description of what will cause nil to be returned.

In macOS 10.6 and later, if the receiver contains multiple items that can provide string, RTF, or RTFD data, the text data from each item is returned as a combined result separated by newlines.

Special Considerations

It’s a good idea to check types or call availableTypeFromArray: before invoking stringForType:. Although performing this check isn’t required, doing so can help you determine if a nil result from a reading method is due to something like a pasteboard timeout.

See Also

Reading Data

- readObjectsForClasses:options:

Reads from the receiver objects that best match the specified array of classes.

NSPasteboardReadingOptionKey

These options can be used for both the readObjectsForClasses:options: and canReadObjectForClasses:options: methods, unless otherwise specified. The currently available options allow for customization of how URLS are read from the pasteboard.

pasteboardItems

An array that contains all the items held by the receiver or nil if there is an error retrieving pasteboard items.

- indexOfPasteboardItem:

Returns the index of the specified pasteboard item.

- dataForType:

Returns the data for the specified type from the first item in the receiver that contains the type.

- propertyListForType:

Returns the property list for the specified type from the first item in the receiver that contains the type.