- Inherits from:
- NSSavePanel : NSPanel : NSWindow : NSResponder : NSObject
- Package:
- com.apple.yellow.application
NSOpenPanel provides the Open panel for the Cocoa user interface. Applications use the Open panel as a convenient way to query the user for the name of a file to open. The Open panel can only be run modally.
Most of this class's behavior is defined by its superclass, NSSavePanel. NSOpenPanel adds to this behavior by:
Typically, you access an NSOpenPanel by invoking the openPanel static method. When the class receives an openPanel message, it tries to reuse an existing panel rather than create a new one. If a panel is reused, its attributes are reset to the default values so that the effect is the same as receiving a new panel. Because Open panels may be reused, you shouldn't modify the instance returned by openPanel except through the methods listed below (and those inherited from NSSavePanel). For example, you can set the panel's title and whether it allows multiple selection, but not the arrangement of the buttons within the panel. If you must modify the Open panel substantially, create and manage your own instance using the constructors rather than the openPanel method.
- Constructors
- NSOpenPanel
- Obtaining the shared instance
- openPanel
- Running the panel modally
- runModalInDirectory
- runModalForTypes
- Getting the user selection
- filenames
- Allowing browser selections
- setCanChooseFiles
- canChooseFiles
- setCanChooseDirectories
- canChooseDirectories
- Allowing multiple selections
- setAllowsMultipleSelection
- allowsMultipleSelection
public NSOpenPanel()
public NSOpenPanel(
NSRect aRect,
int anInt,
int anInt,
boolean aBoolean)
public NSOpenPanel(
NSRect aRect,
int anInt,
int anInt,
boolean aBoolean,
NSScreen aScreen)
public static NSOpenPanel openPanel()
public boolean allowsMultipleSelection()
null
value only if one and
only one file is selected. By contrast, NSOpenPanel's filenames method
always returns the selected files, even if only one file is selected. See Also: filename (NSSavePanel), filenames, setAllowsMultipleSelection
public boolean canChooseDirectories()
See Also: setCanChooseDirectories
public boolean canChooseFiles()
See Also: setCanChooseFiles
public NSArray filenames()
public int runModalInDirectory(
String directory,
String filename,
NSArray fileTypes)
OKButton
or CancelButton
,
respectively. The NSOpenPanel displays the files
in directory (an absolute directory
path) that match the types in fileTypes (an
NSArray of file extensions). If directory is null
the
default directory is the application directory. If all files in
a directory should appear in the browser, fileTypes should
be null
. You can control whether
directories and files appear in the browser with the setCanChooseDirectories and setCanChooseFiles methods.
The filename argument specifies a particular
file in directory that is selected
when the Open panel is presented to the user; otherwise, filename should
be null
. See Also: runModalForTypes
public int runModalForTypes(NSArray fileTypes)
null
for both the filename and directory arguments. See
the description of runModalInDirectory for
details. The fileTypes argument is
an NSArray containing the extensions of files to be shown in the
browser. Returns OKButton
(if the
user clicks the OK button) or CancelButton
(if
the user clicks the Cancel button).public void setAllowsMultipleSelection(boolean flag)
See Also: allowsMultipleSelection
public void setCanChooseDirectories(boolean flag)
true
.See Also: canChooseDirectories
public void setCanChooseFiles(boolean flag)
See Also: canChooseFiles
public NSArray URLs()