Type Method

autosavesInPlace()

Returns whether the receiver supports autosaving in place.

Declaration

class func autosavesInPlace() -> Bool

Return Value

true if the receiver supports autosaving in place; false otherwise.

Discussion

The default implementation of this method returns false. You can override it and return true to declare that your subclass of NSDocument can do autosaving in place. You should not invoke this method to find out whether autosaving in place is actually being done at any particular moment. You should instead use the NSSaveOperationType parameter that the system passes to your overrides of save and write methods.

AppKit invokes this method at a variety of times, and not always on the main thread. For example, autosave(withImplicitCancellability:completionHandler:) invokes this method as part of determining whether the autosaving will be performed in place (autosaveInPlaceOperation) or in a separate autosave directory (autosaveElsewhereOperation). As another example, the canClose(withDelegate:shouldClose:contextInfo:) method and the NSDocumentController machinery for handling unsaved changes at app termination time both invoke this method as part of determining whether alerts about unsaved changes should be presented to the user.