Instance Property

canDownloadUbiquitousContents

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

Declaration

@property BOOL canDownloadUbiquitousContents;

Discussion

When the value of this property is YES, 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 NO, 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 YES, 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 NO and download the file’s contents (with NSFileCoordinator) and show downloading progress (with NSProgress or NSMetadataQuery) in the context of your application, instead of relying on the Open panel to do it.

See Also

Managing Ubiquitous Documents

canResolveUbiquitousConflicts

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