Type Method

addFilePresenter(_:)

Registers the specified file presenter object so that it can receive notifications.

Declaration

class func addFilePresenter(_ filePresenter: NSFilePresenter)

Parameters

filePresenter

The file presenter object to register.

Discussion

This method registers the file presenter object process wide. Thus, any file coordinator objects you create later automatically know about the file presenter object and know to message it when its file or directory is affected.

Be sure to balance calls to this method with a corresponding call to the removeFilePresenter(_:) method. You must remove file presenters from the process wide registry before the object is deallocated, even in a garbage-collected application.

If you call this method while coordinated file operations are already under way in another process, your file presenter may not receive notifications for that operation. To prevent missing such notifications, create a file coordinator, call its coordinate(readingItemAt:options:error:byAccessor:) method, and register your file presenter object there. If you are going to read a file and then create a file presenter for that file, both actions should occur in the same coordinated read block. Synchronizing on the presented file or directory guarantees that when your block executes, all other objects have completed any tasks and you have sole access to the item.

See Also

Related Symbols

class func removeFilePresenter(NSFilePresenter)

Unregisters the specified file presenter object.