jagapen@smithlab.chem.wisc.edu
)n.pero@mi.flashnet.it
)mirko.viviani@rccr.cremona.it
)Standard panel for saving files
Copyright: (C) 1999, 2000 Free Software Foundation, Inc.
- Declared in:
- AppKit/NSSavePanel.h
Standards:
- MacOS-X
- OpenStep
- GNUstep
Implements a panel that allows the user to save a file.
There is only one save panel per application and this panel is obtained by calling the +savePanel class method. From here, you should set the required file extension using -setRequiredFileType: When ready to show the panel, use the -runModal , or a similar method to show the panel in a modal session. Other methods allow you to set the initial directory and initially choosen file. The method will return one of NSOKButton or NSCancelButton depending on which button the user pressed.
Use the -filename method to retrieve the name of the file the user choose.
Method summary
Returns the shared NSSavePanel instance
Description forthcoming.
Returns the accesory view (if any).
Description forthcoming.
Description forthcoming.
Returns the directory choosen by the user. Do not invoke directory within a modal loop because the information that these methods fetch is updated only upon return.
Returns the absolute filename choosen by the user. Do not invoke filename within a modal loop because the information that these methods fetch is updated only upon return.
Description forthcoming.
Description forthcoming.
Description forthcoming.
Returns the prompt used in the current path field.
Returns the required file type. The default is no required file type.
Shows the save panel for the user. This method invokes -runModalForDirectory:file: with empty strings for the filename. Returns NSOKButton (if the user clicks the OK button) or NSCancelButton (if the user clicks the Cancel button).
Initializes the panel to the directory
specified by path and, optionally, the
file specified by filename, then displays
it and begins its modal event loop; path and
filename can be empty strings. The method
invokes [NSApplication:-runModalForWindow:] method
with self as the argument. Returns NSOKButton (if the
user clicks the OK button) or NSCancelButton (if the
user clicks the Cancel button). If path is
nil
then the panel displays the last
selected directory or as a last resort, the
current working directory.
Description forthcoming.
Description forthcoming.
Sets an accessory view which is shown near the bottom of the panel. The panel is automatically expanded with enough room to show the extra view. You can use this extra view to customize various characteristics of the file selection mechanism. For instance you could add a popup button which allows the user to select the format that the file is saved in (e.g. rtf or txt). See also -validateVisibleColumns .
Description forthcoming.
Sets the current path name in the Save panel's browser. The path argument must be an absolute path name.
Description forthcoming.
Returns the prompt of the Save panel field that holds the current pathname or file name. By default this prompt is 'Name: '.
Specifies the type, a file name extension to be appended to any selected files that don't already have that extension; The argument type should not include the period that begins the extension. Invoke this method each time the Save panel is used for another file type within the application.
Sets the title of the NSSavePanel to title. By default, 'Save' is the title string. If you adapt the NSSavePanel for other uses, its title should reflect the user action that brings it to the screen.
Sets the NSSavePanel's behavior for displaying file
packages (for example, MyApp.app) to the user. If
flag is YES
, the user is
shown files and subdirectories within a file package.
If NO
, the NSSavePanel shows each file
package as a file, thereby giving no indication
that it is a directory.
Returns the title of the save panel
Returns YES
if file packages are shown
as directories. The default is NO
.
Validates and possibly reloads the browser columns that are visible in the Save panel by causing the delegate method -panel:shouldShowFilename: to be invoked. One situation in which this method would find use is whey you want the browser to show only files with certain extensions based on the selection made in an accessory-view pop-up list. When the user changes the selection, you would invoke this method to revalidate the visible columns.
- Declared in:
- AppKit/NSSavePanel.h
Standards:
- MacOS-X
- OpenStep
- GNUstep
Description forthcoming.
Method summaryDescription forthcoming.
The NSSavePanel sends this message just before the end
of a modal session for each file name displayed or
selected (including file names in multiple
selections). The delegate determines whether
it wants the file identified by filename; it
returns YES
if the file name is valid,
or NO
if the NSSavePanel should stay in its
modal loop and wait for the user to type in or select
a different file name or names. If the delegate refuses a
file name in a multiple selection, none of the file
names in the selection are accepted.
Description forthcoming.
Description forthcoming.