How do I put a window in a separate NIB, give it its own NSWindowController, make it slide out as a sheet?
(Is this a typical thing to do with sheets?)
I am trying to show a custom sheet (a window that slides down from the title bar of the parent window) from my main window. What I'm trying to do is standard, I think, but I cannot find clear examples or explanations for how to do exactly what I want.
What I am trying to do:
- My app delegate owns the main window, which has a button to open a "settings" sheet.
- The "settings" sheet:
- is in a separate NIB.
- has file owner set to class SettingsWindowController, which is subclass of NSWindowsController
- When user clicks "settings", I am trying to use Apple's [sample code][1]
- (void)showCustomSheet: (NSWindow *)window
// User has asked to see the custom display. Display it.
{
if (!settingsSheet)
//Check the settingsSheet instance variable to make sure the custom sheet does not already exist.
[NSBundle loadNibNamed:@"SettingsSheet" owner: self];
//BUT HOW DOES THIS MAKE settingsSheet NOT nil?
[NSApp beginSheet: settingsSheet
modalForWindow: window
modalDelegate: self
didEndSelector: @selector(didEndSheet:returnCode:contextInfo:)
contextInfo: nil];
// Sheet is up here.
// Return processing to the event loop
}
Please excuse the following simplistic and numerous questions:
- When I call,
loadNibName:owner:
, I don't wantowner
to beself
, because that makes my app delegate the owner of the "MyCustomSheet" - that's what mySettingsWindowsController
is supposed to be for. However, I don't know how makeSettingsWindowsController
the owner in this method. - If my sheet has "Visible at launch" checked, then
loadNibName:owner:
immediately displays the window as a normal window, not as a sheet that slides out from the main window. - If my sheet has "Visible at launch" not checked, then
beginSheet:modalForWindow:etc
causes "Modal session requires modal window". I'm pretty sure this is because I made the Nib's ownerself
(as I mentioned already). - In the sample code, I don't know how the Nib named @"SettingsSheet" is "associated" with the instance variable
settingsSheet
- but they apparently are related because the code checks first:if (!settingsSheet)
(I've marked this with comment//BUT HOW DOES THIS MAKE settingsSheet NOT nil?
)
Thanks for your patience in reading all this!