init?(contentsOf : URL!)
init(item: NSSecureCoding?, typeIdentifier : String?)
NSItemProvider
type coercion policy.
アイテムプロバイダをあるオブジェクトで初期化します、NSItemProvider
型強制方針に従います。
init()
init(object: NSItemProviderWriting)
Availability 有効性
Technology
class NSItemProvider : NSObject
Starting in iOS 11, item providers play a central role in drag and drop, and in copy/paste. They continue to play a role with app extensions. iOS 11から、それらアイテムプロバイダはドラッグ&ドロップ、そしてコピー/ペーストにおいて中心的役割を果たします。それらは引き続いてアプリ拡張である役割を演じます。
All completion blocks used in the NSItem
class are called by the system on an internal queue. When using an item provider with drag and drop, ensure that user-interface updates take place on the main queue as follows:
NSItem
クラスにおいて使われる全ての完了ブロックは、システムによって内部キュー上で呼び出されます。アイテムプロバイダをドラッグ&ドロップで使う場合、ユーザインターフェイス更新がメインキュー上で以下のようにとり行われることを確実にしてください:
An app extension typically encounters item providers when examining the attachments
property of an NSExtension
object. During that examination, the extension can use the has
method to look for data that it recognizes. Item providers use Uniform Type Identifier (UTI) values to identify the data they contain. After finding a type of data that your extension can use, it calls the load
method to load the actual data, which is delivered to the provided completion handler.
あるアプリ拡張が概してアイテムプロバイダそれらに出くわすのは、NSExtension
オブジェクトのattachments
プロパティを検査する時です。その検査の間、その拡張はhas
メソッドを使って、それが認識するところのデータを捜します。アイテムプロバイダそれらは、Uniform Type Identifier(UTI)値を使うことでそれらが含むデータを識別します。あなたの拡張に使用できるデータの型の発見後、それはload
メソッドを呼び出すことで実際のデータをロードし、それはその添付の完了ハンドラに送り届けられます。
You can create item providers to vend data to another process. An extension that modifies an original data item can create a new NSItemProvider object to send back to the host app. When creating data items, you specify your data object and the type of that object. You can optionally use the preview
property to generate a preview image for your data.
あなたは、それらアイテムプロバイダを作成することでデータを別のプロセスに供給できます。元のデータ項目を修正する拡張は、新しいNSItemProviderオブジェクトを作成してホストアプリに送り返せます。データ項目を作成する時、あなたはあなたのデータオブジェクトとそのオブジェクトの型を指定します。あなたは、随意にpreview
プロパティを使って、あなたのデータのプレビューイメージを生成できます。
A single item provider may use custom blocks to provide its data in many different formats. When configuring an item provider, use the register
method to register your blocks and the formats each one supports. When a client requests data in a particular format, the item provider executes the corresponding block, which is then responsible for coercing the data to the appropriate type and returning it to the client.
ある単一のアイテムプロバイダが、あつらえのブロックを使うことで、それのデータを多くの異なる形式で提供できます。アイテムプロバイダを構成設定する場合、register
メソッドを使って、あなたのブロックそれらとそのそれぞれがサポートする形式を登録してください。クライアントがデータをある特定の形式で求める時、アイテムプロバイダはその対応するブロックを実行し、それがそのときデータを適切な型に強制することおよびそれをクライアントに返すことに責任を負います。
init?(contentsOf : URL!)
init(item: NSSecureCoding?, typeIdentifier : String?)
NSItemProvider
type coercion policy.
アイテムプロバイダをあるオブジェクトで初期化します、NSItemProvider
型強制方針に従います。
init()
init(object: NSItemProviderWriting)
var preferredPresentationSize : CGSize
var preferredPresentationStyle : NSItemProvider.PreferredPresentationStyle
enum NSItemProvider.PreferredPresentationStyle
var suggestedName : String?
func canLoadObject (ofClass : NSItemProviderReading.Type) -> Bool
func hasItemConformingToTypeIdentifier (String) -> Bool
hasRepresentationConforming(toTypeIdentifier:fileOptions:)
method, but with the fileOptions
parameter set to a value of 0
.
便宜メソッドはhasRepresentationConforming(toTypeIdentifier:fileOptions:)
メソッドと同等です、しかしfileOptions
パラメータは0
の値に設定された状態です。
func hasRepresentationConforming (toTypeIdentifier : String, fileOptions : NSItemProviderFileOptions) -> Bool
var registeredTypeIdentifiers : [String]
func registeredTypeIdentifiers (fileOptions : NSItemProviderFileOptions) -> [String]
func loadItem (forTypeIdentifier : String, options: [AnyHashable : Any]?, completionHandler : NSItemProvider.CompletionHandler?)
func loadDataRepresentation (forTypeIdentifier : String, completionHandler : (Data?, Error?) -> Void) -> Progress
Data
object, returning a Progress
object.
提供された、型付けされたデータをData
オブジェクトへと非同期にコピーします、Progress
オブジェクトを返します。
func loadFileRepresentation (forTypeIdentifier : String, completionHandler : (URL?, Error?) -> Void) -> Progress
Progress
object.
提供された、型付けされたデータを一時ファイルへと非同期に書き出します、Progress
オブジェクトを返します。
func loadInPlaceFileRepresentation (forTypeIdentifier : String, completionHandler : (URL?, Bool, Error?) -> Void) -> Progress
Progress
object.
ファイルをその場で非同期に開きます、そうすることが可能ならば、Progress
オブジェクトを返します。
func loadObject (ofClass : NSItemProviderReading.Type, completionHandler : (NSItemProviderReading?, Error?) -> Void) -> Progress
Progress
object.
指定されたクラスのオブジェクトをアイテムプロバイダに非同期にロードします、Progress
オブジェクトを返します。
func loadPreviewImage (options: [AnyHashable : Any]!, completionHandler : NSItemProvider.CompletionHandler!)
var previewImageHandler : NSItemProvider.LoadHandler?
func registerCloudKitShare (CKShare, container: CKContainer)
func registerCloudKitShare (preparationHandler : ((CKShare?, CKContainer?, Error?) -> Void) -> Void)
func registerDataRepresentation (forTypeIdentifier : String, visibility: NSItemProviderRepresentationVisibility, loadHandler : ((Data?, Error?) -> Void) -> Progress?)
func registerItem (forTypeIdentifier : String, loadHandler : NSItemProvider.LoadHandler)
NSItemProvider
type coercion policy.
項目を遅延に登録します、NSItemProvider
型強制方針に従います。
func registerFileRepresentation (forTypeIdentifier : String, fileOptions : NSItemProviderFileOptions, visibility: NSItemProviderRepresentationVisibility, loadHandler : ((URL?, Bool, Error?) -> Void) -> Progress?)
func registerObject (NSItemProviderWriting, visibility: NSItemProviderRepresentationVisibility)
NSItemProviderWriting
protocol and adhering to a visibility specification.
指定されたオブジェクトの表現をアイテムプロバイダに加えます、オブジェクトの持つNSItemProviderWriting
プロトコルの実装に基づきそして可視性仕様を遵守します。
func registerObject (ofClass : NSItemProviderWriting.Type, visibility: NSItemProviderRepresentationVisibility, loadHandler : ((NSItemProviderWriting?, Error?) -> Void) -> Progress?)
NSItemProviderWriting
protocol and adhering to a visibility specification.
ある指定されたオブジェクトの表現をアイテムプロバイダに遅延に加えます、オブジェクトの持つNSItemProviderWriting
プロトコルの実装に基づきそして可視性仕様を遵守します。
var sourceFrame : NSRect
var containerFrame : NSRect
typealias NSItemProvider.CompletionHandler
typealias NSItemProvider.LoadHandler
class let errorDomain : String
NSItemProvider
class.
NSItemProvider
クラスと結び付けられるエラードメイン。
struct NSItemProviderFileOptions
protocol NSItemProviderReading
protocol NSItemProviderWriting
enum NSItemProviderRepresentationVisibility
enum NSItemProvider.ErrorCode
class NSExtensionItem