instantiateInitialController(creator:)
Creates the initial window controller from the storyboard and initializes it using your custom code.
Declaration
func instantiateInitialController<Controller>(creator: ((NSCoder) -> Controller?)? = nil) -> Controller? where Controller : NSWindowControllerParameters
- creator:
A block that contains your custom creation code for the window controller. Use this block to create the window controller, initialize it with the provided coder object and any custom information you require, and return the result. This block returns a new window controller object and takes the following parameter:
- coder
The coder object that contains the storyboard data to use when configuring the window controller.
If you return
nilfrom your block, this method creates the window controller using the default Init(coder:) method.
Discussion
Every storyboard file has an initial controller object that represents the default interface to create. Use this method to construct that object using a custom code that you provide. Use this method when the constructor for your object takes parameters in addition to the specified coder object.
In your creator block, create the window controller using your custom constructor method. Your custom constructor method must accept an NSCoder parameter and must call the inherited init(coder:) method at some point during its execution. Not doing so is a programmer error.