beginSheetModal(for:completionHandler:)
Runs the alert modally as a sheet attached to the specified window.
Declaration
func beginSheetModal(for sheetWindow: NSWindow, completionHandler handler: ((NSApplication.ModalResponse) -> Void)? = nil)func beginSheetModal(for sheetWindow: NSWindow) async -> NSApplication.ModalResponseParameters
- sheetWindow:
The window on which to display the sheet.
- handler:
The completion handler that gets called when the sheet’s modal session ends.
Discussion
This method uses the NSWindow sheet methods to display the alert (for more information, see Managing Sheets). If the alert has an alert style of NSCriticalAlertStyle, it is presented as a critical sheet, which means that it can display on top of other sheets that might already be attached to the window. Otherwise, it is presented—or queued for presentation—as a standard sheet.
Note that orderOut(_:) no longer needs to be called in the completion handler. If you don’t dismiss the alert, it will be done for you after the completion handler finishes.