Contents

openUntitledDocumentAndDisplay(_:)

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

Declaration

func openUntitledDocumentAndDisplay(_ displayDocument: Bool) throws -> NSDocument

Parameters

  • displayDocument:

    True if the user interface for the document should be shown, otherwise False.

Return Value

Returns the new NSDocument object, or nil if a new untitled document could not be created. If this method returns nil, it also sets the address referenced by outError to an NSError object that tell why the document could not be created.

Discussion

The default implementation of this method calls defaultType to determine the type of new document to create, calls makeUntitledDocument(ofType:) to create it, then calls addDocument(_:) to record its opening.

When displayDocument is true, this method sends the new document makeWindowControllers() and showWindows() messages. In this scenario, showWindows() shows only the window controllers that have been assigned to the document.

See Also

Creating and Opening Documents