primaryPresentedItemURL

optional var primaryPresentedItemURL: URL? { get }

Discussion 議論

This property supports App Sandbox in macOS. このプロパティは、App SandboxをmacOSにおいてサポートします。

Some apps require access to secondary files or directories with names that are related to the primary, user-selected file. For example, a subtitle file, by convention, has the same name as its corresponding movie file, but with a different filename extension. If a movie player is sandboxed, an NSOpenPanel object will grant access only to the user-selected movie file (the primary item) and not its associated subtitle file (the secondary item). いくつかのアプリは、セカンダリのファイルまたはディレクトリにプライマリ（ユーザ選択ファイル）に結び付けられる名前でアクセスする必要があります。例えば、字幕ファイルは、慣例によって、それの対応するムービーファイルと同じ名前を、しかし異なるファイル名拡張子で持ちます。ムービーファイルがサンドボックスされるならば、NSOpenPanelオブジェクトはユーザ選択されたムービーファイル（プライマリ項目）およびそれの結び付けられた字幕ファイル（セカンダリ項目）にのみアクセスを認めます。

To gain access to a secondary item, first register an NSFilePresenter object for it. At any point in its existence, a secondary item must be able to return an NSURL object to its primary item. This is done by using this property. When done accessing the secondary item, unregister the file presenter object. セカンダリ項目へのアクセスを手に入れるには、まずNSFilePresenterオブジェクトをそれに登録してください。それの存在のどこかの時点で、セカンダリ項目はNSURLオブジェクトをそれのプライマリ項目に返すことができなければなりません。これは、このプロパティを使うことによって行われます。セカンダリ項目へのアクセスを終わった時、ファイルプレゼンタオブジェクトを登録解除してください。