Platforms to show: All Mac Windows Linux Cross-Platform

NSSavePanelMBS class

Super class: NSPanelMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
class Navigation MBS MacCocoa Plugin 7.8 ✅ Yes ❌ No ❌ No ❌ No Desktop only
The class for a Cocoa Save Panel.
Example

dim n as new NSSavePanelMBS

dim e as integer = n.runModal

if e = n.NSCancelButton then
// cancelled
Break
elseif e = n.NSOKButton then
// got file
dim file as FolderItem = n.file
Break
end if

Subclass of the NSPanelMBS class.

Constants

Constant Value Description
NSCancelButton 0 One of the result codes you may need with this class.
NSOKButton 1 One of the result codes you may need with this class.

Super class NSPanelMBS

  • 3 properties
  • method Constructor(x as Double, y as Double, w as Double, h as Double, styleMask as Integer, BackingStoreType as Integer, deferCreation as boolean)
  • 12 shared methods
    • shared method RunAlertPanel(title as string, message as string, defaultButton as string, alternateButton as string, otherButton as string) as Integer
    • shared method RunAlertPanelRelativeToWindow(title as string, message as string, defaultButton as string, alternateButton as string, otherButton as string, docWindow as DesktopWindow) as integer
    • shared method RunAlertPanelRelativeToWindow(title as string, message as string, defaultButton as string, alternateButton as string, otherButton as string, docWindow as NSWindowMBS) as Integer
    • shared method RunAlertPanelRelativeToWindow(title as string, message as string, defaultButton as string, alternateButton as string, otherButton as string, docWindow as window) as Integer
    • shared method RunCriticalAlertPanel(title as string, message as string, defaultButton as string, alternateButton as string, otherButton as string) as Integer
    • shared method RunCriticalAlertPanelRelativeToWindow(title as string, message as string, defaultButton as string, alternateButton as string, otherButton as string, docWindow as DesktopWindow) as integer
    • shared method RunCriticalAlertPanelRelativeToWindow(title as string, message as string, defaultButton as string, alternateButton as string, otherButton as string, docWindow as NSWindowMBS) as Integer
    • shared method RunCriticalAlertPanelRelativeToWindow(title as string, message as string, defaultButton as string, alternateButton as string, otherButton as string, docWindow as window) as Integer
    • shared method RunInformationalAlertPanel(title as string, message as string, defaultButton as string, alternateButton as string, otherButton as string) as Integer
    • shared method RunInformationalAlertPanelRelativeToWindow(title as string, message as string, defaultButton as string, alternateButton as string, otherButton as string, docWindow as DesktopWindow) as integer
    • shared method RunInformationalAlertPanelRelativeToWindow(title as string, message as string, defaultButton as string, alternateButton as string, otherButton as string, docWindow as NSWindowMBS) as Integer
    • shared method RunInformationalAlertPanelRelativeToWindow(title as string, message as string, defaultButton as string, alternateButton as string, otherButton as string, docWindow as window) as Integer
  • 10 constants

Constants

Constant Value Description
NSAlertAlternateReturn 0 One of the possible return values for the alert panels. The user pressed the alternate button.
NSAlertDefaultReturn 1 One of the possible return values for the alert panels. The user pressed the default button.
NSAlertErrorReturn -2 One of the possible return values for the alert panels. The alert cannot identify the reason it was closed; it may have been closed by an external source or by a button other than those listed above.
NSAlertOtherReturn -1 One of the possible return values for the alert panels. The user pressed a second alternate button.
NSCancelButton 0 One of the constants for the modal panel return values. The Cancel button.
NSDocModalWindowMask 64 One of the constants you can use to specify the style when creating a window. The panel is created as a modal sheet.
NSHUDWindowMask 8192 One of the constants you can use to specify the style when creating a window.
NSNonactivatingPanelMask 128 One of the constants you can use to specify the style when creating a window. The panel can receive keyboard input without activating the owning application.
NSOKButton 1 One of the constants for the modal panel return values. The OK button.
NSUtilityWindowMask 16 One of the constants you can use to specify the style when creating a window. The panel is created as a floating window.

Super class NSWindowMBS

Super class NSResponderMBS

Sub classes:

Some events using this class:

Some examples using this class:

Blog Entries

Xojo Developer Magazine

Release notes

  • Version 23.0
  • Version 20.1
    • Fixed NameFieldStringValue in NSSavePanelMBS to properly set with empty text.
  • Version 19.4
    • Fixed title property for NSSavePanelMBS to avoid NSException for empty string.

The items on this page are in the following plugins: MBS MacBase Plugin, MBS MacCocoa Plugin.


NSRunningApplicationMBS   -   NSSavePanelObserverMBS


The biggest plugin in space...