Instance Property

canDownloadUbiquitousContents

A Boolean that controls how the panel responds to ubiquitous documents that aren't yet fully downloaded locally.

Declaration

var canDownloadUbiquitousContents: Bool { get set }

Discussion

When the value of this property is true, then the receiver will disallow opening non-local ubiquitous files. If the user attempts to select a non-local file, the panel will trigger or re-prioritize downloading for that file so that it can be opened as soon as possible. When the value of this property is false, then the panel will allow the user to select and open non-local files, giving your application responsibility for downloading and reporting progress. The default value is true, except for applications linked against the OS X v10.9 SDK or earlier that have adopted iCloud by specifying a ubiquitous container identifier entitlement.

To provide the ideal user experience, you should set this property to false and download the file’s contents (with NSFileCoordinator) and show downloading progress (with Progress or NSMetadataQuery) in the context of your application, instead of relying on the Open panel to do it.

See Also

Managing Ubiquitous Documents

var canResolveUbiquitousConflicts: Bool

A Boolean that controls how the panel responds to ubiquitous documents with conflicting versions.