Discussion 議論
Use this block when registering a type-specific coercion handler with the register
method. The parameters for this block are as follows:
このブロックを使う時は、型指定強制ハンドラをregister
メソッドで登録する時です。このブロックに対するパラメータは次のようになります:
- completionHandler
The completion handler to call with the resulting data. For information about this block, see
NSItem
. 結果データとともに呼び出す完了ハンドラ。このブロックについての情報については、Provider .Completion Handler NSItem
を見てください。Provider .Completion Handler - 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
completion
block. ロードされている項目の、期待されるクラス。項目プロバイダの持つデータをこの型に変換して、結果オブジェクトをHandler completion
ブロックの最初のパラメータとして渡してください。Handler - 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 load
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 completion
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.
あるクライアントがload
メソッドを呼び出してふさわしい型を要請する場合、アイテムプロバイダはあなたのブロックを実行します。あなたの実装において、期待される型のオブジェクトを作成してそしてcompletion
パラメータの中のブロックを、新しく作成されたオブジェクトをそのブロックの最初のパラメータとして渡して実行してください。エラーがあるならば、nil
をそのオブジェクトに渡して、何が起こったかを説明する適切なNSError
オブジェクトを提供してください。
This type of block is also used for generating preview images. In the case of a preview image, the expected
is always a NSData
, NSURL
, UIImage
(in iOS), or NSImage
(in macOS) class.
この型のブロックはまた、プレビューイメージを生成するのに使われます。プレビューイメージの場合において、expected
は常にNSData
、NSURL
、UIImage
(iOSでは)、またはNSImage
(macOSでは)クラスです。