scottc@net-community.com
)boehring@biomed.ruhr-uni-bochum.de
)n.pero@mi.flashnet.it
)mirko.viviani@rccr.cremona.it
)Standard panel for opening files
Copyright: (C) 1996, 1998, 1999, 2000 Free Software Foundation, Inc.
- Declared in:
- AppKit/NSOpenPanel.h
Availability: Not in OpenStep/MacOS-X
- Conforms to:
- NSCoding
Implements a panel that allows the user to select a file or files. NSOpenPanel is based on the NSSavePanel implementation and shares a lot of similarities with it.
There is only one open panel per application and this
panel is obtained by calling the
+openPanel
class method. From here, you should set the
characteristics of the file selection
mechanism using the
-setCanChooseFiles:
,
-setCanChooseDirectories:
and
-setAllowsMultipleSelection:
methods. The default is YES
except
for allowing multiple selection. When ready to show the
panel, use the
-runModalForTypes:
, or a similar method to show the panel in a modal
session. Other methods allow you to set the
initial directory and initially selected file. The
method will return one of NSOKButton or
NSCancelButton depending on which button the
user pressed.
Use the -filename or -filenames method to retrieve the name of the file the user selected.
Returns the shared NSOpenPanel instance
Returns an array of the selected files as URLs
Returns YES
if the user is allowed to
select multiple files. The default behavior is not
to allow mutiple selections.
Description forthcoming.
Returns YES
if the user is allowed to
choose directories The default behavior is to allow
choosing directories.
Returns YES
if the user is allowed to
choose files. The default behavior it to allow
choosing files.
Returns an array containing the absolute paths (as NSString objects) of the selected files and directories. If multiple selections aren't allowed, the array contains a single name.
Description forthcoming.
Displays the open panel in a modal session, with
the directory path shown and file
name (if any) selected. Files are filtered
for the specified types. If the directory is
nil
, then the directory shown in the
open panel is the last directory selected.
Description forthcoming.
Displays the open panel in a modal session, filtering for files that have the specified types
Allows the user to select multiple files if
flag is YES
.
Allows the user to choose directories if
flag is YES
.
Allows the user to choose files if flag
is YES
Description forthcoming.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.
Warning the underscore at the start of the name of this instance variable indicates that, even though it is not technically private, it is intended for internal use within the package, and you should not use the variable in other code.