beginSheetForDirectory:file:types:modalForWindow:modalDelegate:didEndSelector:contextInfo:

Declaration

- (void) beginSheetForDirectory:(NSString *) path file:(NSString *) name types:(NSArray *) fileTypes modalForWindow:(NSWindow *) docWindow modalDelegate:(id) delegate didEndSelector:(SEL) didEndSelector contextInfo:(void *) contextInfo;

Parameters

• path:

  The directory whose files the panel displays. When nil, the directory is the same directory used in the previous invocation of the panel; this is probably the best choice for most situations.

• name:

  Specifies a particular file in absoluteDirectoryPath that is selected when the Open panel is presented to the user. When nil, no file is initially selected.

• fileTypes:

  An array of file extensions and/or HFS file types. Specifies the files the panel allows the user to select. nil makes all files in absoluteDirectoryPath selectable by the user. An array of types passed in here will override one set using Allowedfiletypes.

• docWindow:

  The window to open the sheet on.

• delegate:

  This is not the same as a delegate assigned to the panel. This delegate is temporary and the relationship only lasts until the panel is dismissed.

• didEndSelector:

  The message sent to modalDelegate after the modal session has ended, but before dismissing the Open panel. didEndSelector may dismiss the Open panel itself; otherwise, it will be dismissed on return from the method. The corresponding method should have the following signature:

  - (void)openPanelDidEnd:(NSOpenPanel *)panel returnCode:(int)returnCode  contextInfo:(void  *)contextInfo

  The value passed as returnCode will be either NSCancelButton or NSOKButton.

• contextInfo:

  Any context information passed to modalDelegate in the didEndSelector message.

See Also

Related Documentation

• beginSheetModal(for:completionHandler:)

Methods

• filenames
• beginForDirectory:file:types:modelessDelegate:didEndSelector:contextInfo:
• runModalForDirectory:file:types:
• runModalForTypes: