Type Alias

NSItemProvider.LoadHandler

A block that loads the item provider’s data and coerces it to the specified type. アイテムプロバイダの持つデータをロードしてそれを指定された型に強制するブロック。

Declaration 宣言

typealias LoadHandler = (NSItemProvider.CompletionHandler?, AnyClass?, [AnyHashable : Any]?) -> Void

Discussion 議論

Use this block when registering a type-specific coercion handler with the registerItem(forTypeIdentifier:loadHandler:) method. The parameters for this block are as follows: このブロックを使う時は、型指定強制ハンドラをregisterItem(forTypeIdentifier:loadHandler:)メソッドで登録する時です。このブロックに対するパラメータは次のようになります:

completionHandler

The completion handler to call with the resulting data. For information about this block, see NSItemProvider.CompletionHandler. 結果データとともに呼び出す完了ハンドラ。このブロックについての情報については、NSItemProvider.CompletionHandlerを見てください。

expectedValueClass

The expected class of the item being loaded. Convert the item provider’s data to this type and pass the resulting object as the first parameter of the completionHandler block. ロードされている項目の、期待されるクラス。項目プロバイダの持つデータをこの型に変換して、結果オブジェクトをcompletionHandlerブロックの最初のパラメータとして渡してください。

options オプション

A dictionary with options for how to provide the requested item. For example, the dictionary may contain the pixel dimensions of a requested image. For information about the supported keys, see Options Dictionary Key. この要請された項目を提供する方法に対するオプションを持つ辞書。例えば、辞書は要請された画像のピクセル次元それらを含むかもしれません。サポートされるキーについての情報として、オプション辞書キーを見てください。

When a client calls the loadItem(forTypeIdentifier:options:completionHandler:) method and requests the appropriate type, the item provider executes your block. In your implementation, create an object of the expected type and execute the block in the completionHandler parameter, passing the newly created object as the first parameter of that block. If there is an error, pass nil for the object and provide an appropriate NSError object explaining what happened. あるクライアントがloadItem(forTypeIdentifier:options:completionHandler:)メソッドを呼び出してふさわしい型を要請する場合、アイテムプロバイダはあなたのブロックを実行します。あなたの実装において、期待される型のオブジェクトを作成してそしてcompletionHandlerパラメータの中のブロックを、新しく作成されたオブジェクトをそのブロックの最初のパラメータとして渡して実行してください。エラーがあるならば、nilをそのオブジェクトに渡して、何が起こったかを説明する適切なNSErrorオブジェクトを提供してください。

This type of block is also used for generating preview images. In the case of a preview image, the expectedValueClass is always a NSData, NSURL, UIImage (in iOS), or NSImage (in macOS) class. この型のブロックはまた、プレビューイメージを生成するのに使われます。プレビューイメージの場合において、expectedValueClassは常にNSDataNSURLUIImage(iOSでは)、またはNSImage(macOSでは)クラスです。