<!--
{
  "documentType" : "article",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/nsdocumentcontroller-deprecated-symbols",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Deprecated symbols"
}
-->

# Deprecated symbols

Review symbols that are no longer in active development, and their recommended replacements.

## Overview

Although these symbols are available for use, Apple is no longer actively developing them, and may remove them in a future release. Apple recommends moving away from these symbols and using their indicated replacements instead. Check the individual symbol pages for the recommended replacements.

## Topics

### Deprecated methods

[`- (id) documentForFileName:(NSString *) fileName;`](/documentation/AppKit/NSDocumentController/documentForFileName:)

Returns the document object for the file in which the document data is stored.

[`- (NSArray *) fileExtensionsFromType:(NSString *) typeName;`](/documentation/AppKit/NSDocumentController/fileExtensionsFromType:)

Returns the allowable file extensions for the given document type.

[`- (NSArray *) fileNamesFromRunningOpenPanel;`](/documentation/AppKit/NSDocumentController/fileNamesFromRunningOpenPanel)

Returns a selection of files chosen by the user in the Open panel.

[`- (id) makeUntitledDocumentOfType:(NSString *) type;`](/documentation/AppKit/NSDocumentController/makeUntitledDocumentOfType:)

Creates and returns a document object for document type.

[`- (id) makeDocumentWithContentsOfURL:(NSURL *) url ofType:(NSString *) type;`](/documentation/AppKit/NSDocumentController/makeDocumentWithContentsOfURL:ofType:)

Creates and returns a document object for the given document type from the contents of a given URL.

[`- (id) makeDocumentWithContentsOfFile:(NSString *) fileName ofType:(NSString *) type;`](/documentation/AppKit/NSDocumentController/makeDocumentWithContentsOfFile:ofType:)

Creates and returns a document object of a given document type from the contents of a file.

[`- (id) openDocumentWithContentsOfFile:(NSString *) fileName display:(BOOL) display;`](/documentation/AppKit/NSDocumentController/openDocumentWithContentsOfFile:display:)

Returns a document object created from the contents of a given file and optionally displays it.

[`- (id) openDocumentWithContentsOfURL:(NSURL *) url display:(BOOL) display;`](/documentation/AppKit/NSDocumentController/openDocumentWithContentsOfURL:display:)

Returns a document object created from the contents of a given URL and optionally displays it.

[`- (id) openDocumentWithContentsOfURL:(NSURL *) url display:(BOOL) displayDocument error:(NSError **) outError;`](/documentation/AppKit/NSDocumentController/openDocumentWithContentsOfURL:display:error:)

Opens a document located by the given URL presents its user interface if requested, and returns the document if successful.

[`- (id) openUntitledDocumentOfType:(NSString *) type display:(BOOL) display;`](/documentation/AppKit/NSDocumentController/openUntitledDocumentOfType:display:)

Returns a document object instantiated from the subclass of the given document type and optionally displays it.

[`- (BOOL) reopenDocumentForURL:(NSURL *) url withContentsOfURL:(NSURL *) contentsURL error:(NSError **) outError;`](/documentation/AppKit/NSDocumentController/reopenDocumentForURL:withContentsOfURL:error:)

Reopens an autosaved document located by a URL, by reading the contents for the document from another URL, presents its user interface, and returns `true` if successful.

[`- (void) setShouldCreateUI:(BOOL) flag;`](/documentation/AppKit/NSDocumentController/setShouldCreateUI:)

Sets whether the window controllers of a document should be created when the document is created.

[`- (BOOL) shouldCreateUI;`](/documentation/AppKit/NSDocumentController/shouldCreateUI)

Returns a Boolean value that indicates whether the window controllers of a document should be created when the document is created.

[`- (NSString *) typeFromFileExtension:(NSString *) fileNameExtensionOrHFSFileType;`](/documentation/AppKit/NSDocumentController/typeFromFileExtension:)

Returns the document type associated with files having extension `fileExtensionOrHFSFileType`.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)