Instance Method

documentForURL:

Returns, for a given URL, the open document whose file or file package is located by the URL, or nil if there is no such open document.

Declaration

- (__kindof NSDocument *)documentForURL:(NSURL *)url;

Parameters

url

The URL of the document you wish to look up.

Return Value

The newly created NSDocument object, or nil if the document could not be created.

Discussion

The default implementation of this method queries each open document to find one whose URL matches, and returns the first one whose URL does match.

See Also

Creating and Opening Documents

- duplicateDocumentWithContentsOfURL:copying:displayName:error:

Creates a new document by reading the contents for the document from another URL, presents its user interface, and returns the document if successful.

- openDocumentWithContentsOfURL:display:completionHandler:

Opens a document located by a URL, optionally presents its user interface, and calls the passed-in completion handler.

- openUntitledDocumentAndDisplay:error:

Creates a new untitled document, presents its user interface if displayDocument is YES, and returns the document if successful.

- makeDocumentForURL:withContentsOfURL:ofType:error:

Instantiates a document located by a URL, of a specified type, but by reading the contents for the document from another URL, and returns it if successful.

- makeDocumentWithContentsOfURL:ofType:error:

Instantiates a document located by a URL, of a specified type, and returns it if successful.

- makeUntitledDocumentOfType:error:

Instantiates a new untitled document of the specified type and returns it if successful.

- reopenDocumentForURL:withContentsOfURL:display:completionHandler:

Reopens a document, optionally located by a URL, by reading the contents for the document from another URL, optionally presents its user interface, and calls the passed-in completion handler.