instantiateNibWithExternalNameTable:
Unarchives and instantiates the in-memory contents of the receiver’s nib file, creating a distinct object tree and top level objects.
Declaration
- (BOOL) instantiateNibWithExternalNameTable:(NSDictionary *) externalNameTable;Parameters
- externalNameTable:
A dictionary containing entries for the nib file’s owner and top-level objects. See the discussion for more information.
Return Value
true if the nib file’s contents were instantiated successfully; otherwise, false.
Discussion
This is the primitive method for performing instantiations of a nib file. You may use this method to instantiate a nib file multiple times. Each instantiation of the nib must have a distinct owner object that is responsible for the resulting object tree.
If the nib file requires an owner, the externalNameTable parameter must contain the object representing the nib file’s owner (associated with the NSNibOwner key). The parameter may optionally include an NSMutableArray object to be populated with the top-level objects nib file (associated with the NSNibTopLevelObjects key).