Instance Method

addWindowController:

Adds the specified window controller to the current document.

Declaration

- (void)addWindowController:(NSWindowController *)windowController;

Parameters

aController

The window controller that is added.

Discussion

An NSDocument object uses its list of window controllers when it displays all document windows, sets window edited status upon an undo or redo operation, and modifies window titles. If you create window controllers by overriding windowNibName, this method is invoked automatically. If you create window controllers in makeWindowControllers or in any other context, such as in apps that present multiple windows per document, you should invoke this method for each window controller created.

You cannot attach a window controller to more than one document at a time. The default implementation of this method removes the passed-in window controller from the document to which it is attached, if it is already attached to one, then sends it a document message with self as the argument. It also ignores redundant invocations.

You would not typically override this method.

See Also

Creating and Managing Window Controllers

- makeWindowControllers

Creates the window controller objects that the document uses to display its content.

- removeWindowController:

Removes the specified window controller from the receiver’s array of window controllers.

windowControllers

The document’s current window controllers.

windowNibName

The name of the document’s sole nib file.

- windowControllerDidLoadNib:

Called after one of the document's window controllers loads its nib file.

- windowControllerWillLoadNib:

Called before one of the document's window controllers loads its nib file.

- shouldCloseWindowController:delegate:shouldCloseSelector:contextInfo:

Determines whether the system should close the document and its associated window.