(Preliminary Documentation) Copyright ã1994 by NeXT Computer, Inc.  All Rights Reserved.

NSSavePanel 

Inherits From:	NSPanel : NSWindow : NSResponder : NSObject 

Declared In:	appkit/NSNSSavePanel.h 

Allocating, Creating and Freeing a NSSavePanel 

+(NSSavePanel *)savePanel	Creates and returns a recyclable NSSavePanel object.

Customizing the NSSavePanel 

- (void)setAccessoryView:(NSView *)aView	Adds an application-customized view to the save panel. 
- (NSView *)accessoryView	Returns the application-customized view object. 
- (void)setTitle:(NSString *)title	Sets the title of the NSSavePanel to title. 
- (NSString *)title	Returns the title of the NSSavePanel.
- (void)setPrompt:(NSString *)prompt	Sets the title of the form field for the path to prompt.
- (NSString *)prompt	Returns the title of the form field for the path.

Setting Directory and File Type 

- (NSString *)requiredFileType	Gets the required file type (if any). 
- (void)setDirectory:(NSString *)path	Sets the current directory of the NSSavePanel.
- (void)setRequiredFileType:(NSString *)type	Sets the required file type (if any). 
- (void)setTreatsFilePackagesAsDirectories:(BOOL)flag
	Sets whether the NSSavePanel object treats file packages as directories by showing their contents in the browser.
- (BOOL)treatsFilePackagesAsDirectories	Returns YES if the NSSavePanel treats file packages as directories, thereby allowing users to browse the contents of file packages.

Running the NSSavePanel 

- (int)runModalForDirectory:(NSString *)path	Displays the NSSavePanel and begins its event loop,
file:(NSString *)filename	 showing path in the browser and selecting filename. 
- (int)runModal	Displays the NSSavePanel and begins its event loop. 

Reading Save Information 

- (NSString *)directory	Returns the directory that the chosen file resides in. 
- (NSString *)filename	Returns the full name of the file to be saved.

Target and Action Methods 

- (void)ok:(id)sender	Method invoked by the OK button. 
- (void)cancel:(id)sender	Method invoked by the Cancel button.

Responding to User Input 

- (void)selectText:(id)sender	Invoked when users press Tab, Shift-Tab, or an arrow key.

Setting the Delegate 

- (void)setDelegate:(id)anObject	Makes anObject the NSSavePanel's delegate. 

Methods implemented by the Delegate 

- (NSComparisonResult)panel:(id)sender	Returns NSOrderedDescending if filename1 precedes
compareFilename:(NSString *)filename1	  	filename2, NSOrderAscending in the opposite case,
with:(NSString *)filename2	 	NSOrderedSame if the two are equivalent.
caseSensitive:(BOOL)caseSensitive	 
- (BOOL)panel:(id)sender	Returns YES if filename should be displayed in the
shouldShowFilename:(NSString *)filename	 	browser. 
- (BOOL)panel:(id)sender	Returns YES if  filename is acceptable to the delegate. 
isValidFilename:(NSString*)filename