Instance Method インスタンスメソッド

loadItem(forTypeIdentifier:options:completionHandler:)

Loads the item’s data and coerces it (as needed) to the specified type. 項目の持つデータをロードして、それを(必要に応じて)指定された型へと強制します。

Declaration 宣言

func loadItem(forTypeIdentifier typeIdentifier: String, 
      options: [AnyHashable : Any]? = nil, 
completionHandler: NSItemProvider.CompletionHandler? = nil)

Parameters パラメータ

typeIdentifier

A string that represents the desired UTI. 望むUTIを表す文字列。

options オプション

A dictionary of keys and values that provide information about the item, such as the size of an image. (See NSItemProviderPreferredImageSizeKey for a key you can use.) 例えば画像のサイズなど、その項目の情報を提供するキーと値からなるある辞書。(NSItemProviderPreferredImageSizeKeyをあなたが使用可能なキーのために見てください。)

completionHandler

A completion handler block to execute with the results. For information about the format of this block, see NSItemProvider.CompletionHandler. 結果で実行する完了ハンドラブロック。このブロックの書式についての情報として、NSItemProvider.CompletionHandlerを見てください。

Discussion 議論

Call this method when you want to retrieve the item provider’s data. If the item provider object is able to provide data in the requested type, it does so and asynchronously executes your completionHandler block with the results. The block may be executed on a background thread. あなたがアイテムプロバイダの持つデータを取ってきたい時に、このメソッドを使ってください。アイテムプロバイダオブジェクトがデータを要請された型で提供できるならば、それはそうします、そして非同期にあなたのcompletionHandlerブロックを結果とともに実行します。ブロックは、バックグラウンドスレッド上で実行されるかもれません。

The type information for the first parameter of your completionHandler block should be set to the class of the expected type. For example, when requesting text data, you might set the type of the first parameter to NSString or NSAttributedString. An item provider can perform simple type conversions of the data to the class you specify, such as from NSURL to NSData or FileWrapper, or from NSData to UIImage (in iOS) or NSImage (in macOS). If the data could not be retrieved or coerced to the specified class, an error is passed to the completion block’s. あなたのcompletionHandlerブロックの最初のパラメータの型情報は、期待される型のクラスに設定されるべきです。例えば、テキストデータを要請する場合、あなたは最初のパラメータの型をNSStringまたはNSAttributedStringに設定するかもしれません。アイテムプロバイダは、データの単純な型変換をあなたが指定するクラスへと実行できます、例えばNSURLからNSDataFileWrapperへ、またはNSDataからUIImage(iOSでは)やNSImage(macOSでは)に。データが回収されないまたは指定されたクラスに強制できないならば、エラーが完了ブロックの持つものに渡されます。

See Also 参照

Loading the Provider’s Contents プロバイダーのもつ内容をロードする