Instance Property

autosavingFileType

Returns the document type that should be used for an autosave operation.

Declaration

@property(readonly, copy) NSString *autosavingFileType;

Discussion

This properties contains a string that identifies the document type for autosave files. The default implementation just returns the value provided by the fileType property. You can override this property and return nil to completely disable autosaving of individual documents (because the NSDocumentController object does not call the autosaveDocumentWithDelegate:didAutosaveSelector:contextInfo: method of a document that has no autosaving file type). You can also override it if your app defines a document type that is specifically designed for autosaving, for example, one that efficiently represents document content changes instead of complete document contents.

Overriding this property can result in incorrect behavior during reopening of autosaved documents. The NSDocument method initForURL:withContentsOfURL:ofType:error:, which is invoked during reopening of autosaved documents after a crash, takes two URLs, but only the type name of the autosaved contents file. The default implementation updates the fileType property with that type name, but that may not be the right thing to do if this property contains something other than fileType during document autosaving. If you override autosavingFileType, you probably need to override initForURL:withContentsOfURL:ofType:error: too, and make the override update fileType with the type of the actual document file, after invoking super. See TextEdit’s Document class for an example of how to do this.

See Also

Autosaving

- checkAutosavingSafetyAndReturnError:

Returns a Boolean value indicating whether it is probably safe to autosave document changes.

- scheduleAutosaving

Schedules periodic autosaving for the purpose of crash protection.

hasUnautosavedChanges

A Boolean value indicating whether the document has changes that have not been autosaved.

- autosaveDocumentWithDelegate:didAutosaveSelector:contextInfo:

Autosaves the document’s contents at an appropriate location.

- autosaveWithImplicitCancellability:completionHandler:

Autosaves the document’s contents at an appropriate location if it needs autosaving.

autosavesInPlace

Returns whether the receiver supports autosaving in place.

autosavesDrafts

Returns whether the receiving subclass of NSDocument supports autosaving of drafts.

preservesVersions

Returns whether the receiving subclass of NSDocument supports Versions.

- browseDocumentVersions:

Opens the Versions browser in the document’s main window.

autosavingIsImplicitlyCancellable

A Boolean value indicating whether autosaving is happening now but could be safely cancelled.

autosavedContentsFileURL

The location of the most recently autosaved document contents.