NSPasteboardItemMBS.availableTypeFromArray(types() as string) as string

types: An array of strings representing UTIs, arranged in order of preference (most preferred as the 0th element in the array).

Returns the first (according to the sender's ordering of types) type in types contained in the pasteboard item, or nil if the receiver does not contain any types given in types.

The method checks for UTI conformance of the requested types, preferring an exact match to conformance.
Available in OS X v10.6 and later.

Some examples using this method:

• /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV Database with DataSource
• /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV Simple Demo with DataSource
• /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV TableView
• /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListboxTV with ContainerControl Cells
• /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Hierarchical & Flat/ListBoxTV OutlineView

NSPasteboardItemMBS.Constructor

NSPasteboardItemMBS.dataForType(type as string) as memoryblock

Var n as new NSPasteboardItemMBS

Var data as MemoryBlock = "Hello World"
Var type as string = NSPasteboardmbs.NSPasteboardTypeString
n.dataForType(type) = data

Var d as MemoryBlock = n.dataForType(type)
MsgBox DefineEncoding(d, encodings.UTF8)

(Read and Write computed property)

NSPasteboardItemMBS.Destructor

NSPasteboardItemMBS.detectMetadata(types() as String, theDelegate as NSPasteboardMBS.detectValuesCompletedMBS, tag as variant = nil)

Because this method only gives access to limited types of metadata and doesn’t allow the app to access the contents, the system doesn’t notify the user about reading the contents of the pasteboard.

For details about the metadata returned for each type.

types: The metadata types to detect on the pasteboard item.
theDelegate: A delegate that the system invokes after detecting metadata on the pasteboard item. The delegate receives either a dictionary with the metadata types found on the pasteboard item or an error if detection failed. The dictionary keys specify the matched metadata types, and the values specify the corresponding metadata.
tag: a value passed on to the delegate.

Requires macOS 15.4 or newer.

NSPasteboardItemMBS.detectPatterns(patterns() as String, theDelegate as NSPasteboardMBS.detectPatternsCompletedMBS, tag as variant = nil)

Because this method only gives an indication of whether a pasteboard item matches a particular pattern and doesn’t allow the app to access the contents, the system doesn’t notify the user about reading the contents of the pasteboard.

patterns: The patterns to detect on the pasteboard item.
theDelegate: A delegate that the system invokes after detecting patterns on the pasteboard item. The delegate receives either a set with the patterns found on the pasteboard item or an error if detection failed.
tag: a value passed on to the delegate.

Requires macOS 15.4 or newer.

NSPasteboardItemMBS.detectValues(patterns() as String, theDelegate as NSPasteboardMBS.detectValuesCompletedMBS, tag as variant = nil)

Important: Calling this method notifies the user that the app has read the contents of the pasteboard, if a match is found.

For details about the types returned for each pattern, see shared methods.

patterns: The patterns to detect on the pasteboard item.
theDelegate: A delegate that the system invokes after detecting patterns on the pasteboard item. The delegate returns either dictionary with the patterns found on the pasteboard item or an error if detection failed. The dictionary keys specify the matched patterns, and the values specify the corresponding content of the pasteboard.
tag: a value passed on to the delegate.

Requires macOS 15.4 or newer.

NSPasteboardItemMBS.propertyListForType(type as string) as Variant

Stores a property list object (array, dictionary, string, numbers, memoryblocks)
Available in OS X v10.6 and later.
(Read and Write computed property)

NSPasteboardItemMBS.setDataProviderForType(dataProvider as NSPasteboardItemDataProviderMBS, types() as string) as boolean

dataProvider: A pasteboard data provider.
types: An array of strings indicating the UTIs for the data representations dataProvider may provide.

Returns true if the data provider was set successfully, otherwise false.

This method registers the data provider to be messaged to provide the data for any of the specified types when requested.
Available in OS X v10.6 and later.

Some examples using this method:

• /MacCocoa/Custom NSViewControl Drag
• /MacControls/Custom NSView Drag

NSPasteboardItemMBS.stringForType(type as string) as string

Var n as new NSPasteboardItemMBS

Var type as string = NSPasteboardmbs.NSPasteboardTypeString
n.stringForType(type) = "Hello World"
MsgBox n.stringForType(type)

type: A UTI type string.

Available in OS X v10.6 and later.
(Read and Write computed property)

NSPasteboardItemMBS.types as string()

Available in OS X v10.6 and later.