Instance Method

beginSheetModal(for:completionHandler:)

Presents the panel as a sheet modal to the specified window.

Declaration

func beginSheetModal(for window: NSWindow, completionHandler handler: @escaping (NSApplication.ModalResponse) -> Void)

Parameters

window

The window in which the panel will be presented.

handler

The block called after the user dismisses the panel. The argument passed in will be NSFileHandlingPanelOKButton if the user chose the OK button or NSFileHandlingPanelCancelButton if the user chose the Cancel button.

Discussion

Any properties of the panel you wish to set should be set before calling this method. Although the completion handler block is called after the user dismisses the panel, the panel sheet may still be visible onscreen. If you need to remove the sheet from the screen—for example, if the completion block displays an alert—first call [savePanel orderOut:nil] to close the sheet.

See Also

Running Panels

func runModal() -> NSApplication.ModalResponse

Displays the panel and begins its event loop with the current working (or last selected) directory as the default starting point.

func validateVisibleColumns()

Validates and possibly reloads the browser columns visible in the panel by invoking the delegate method panel:shouldShowFilename:.