 |
Chapter 19 java.awt Reference |
 |
FileDialog
Name
FileDialog
![[Graphic: Figure from the text]](./figs/filedi2.gif)
Description
The FileDialog class provides file selection capabilities for opening or saving files. Because FileDialog is a subclass of Dialog, a FileDialog is always associated with a Frame and is hidden by default. FileDialogs are always modal (i.e., they always attract all user input). In addition, FileDialogs have a load/save mode; the LOAD mode is for selecting files for an application to load, SAVE is for selecting a filename to save.
Class Definition
public class java.awt.FileDialog
extends java.awt.Dialog {
// Constants
public final static int LOAD;
public final static int SAVE;
// Constructors
public FileDialog (Frame parent); 
public FileDialog (Frame parent, String title);
public FileDialog (Frame parent, String title, int mode);
// Instance Methods
public void addNotify();
public String getDirectory();
public String getFile();
public FilenameFilter getFilenameFilter();
public int getMode();
public synchronized void setDirectory (String directory);
public synchronized void setFile (String file);
public synchronized void setFilenameFilter (FilenameFilter filter);
public void setMode(int mode);
// Protected Instance Methods
protected String paramString();
}
Constants
LOAD
public final static int LOAD
Constant to specify the FileDialog's load mode.
SAVE
public final static int SAVE
Constant to specify the FileDialog's save mode.
Constructors
FileDialog
public FileDialog (Frame parent)
- Parameters
-
- parent
-
Frame that is to act as parent of FileDialog.
- parent
- Description
-
Constructs a FileDialog object in LOAD mode.
public FileDialog (Frame parent, String title)
- Parameters
-
- parent
-
Frame that is to act as parent of FileDialog.
- title
-
Title to use for FileDialog.
- parent
- Description
-
Constructs a FileDialog object in LOAD mode.
public FileDialog (Frame parent, String title, int mode)
- Parameters
-
- parent
-
Frame that is to act as parent of Dialog.
- title
-
Title to use for FileDialog.
- mode
-
The constant LOAD or SAVE, specifying the dialog's mode.
- parent
- Description
-
Constructs a FileDialog object in the given mode.
Instance Methods
addNotify
public void addNotify()
- Overrides
-
Dialog.addNotify()
- Description
-
Creates FileDialog's peer for the native platform.
getDirectory
public String getDirectory()
- Returns
-
The current directory for the FileDialog.
getFile
public String getFile()
- Returns
-
The current file selected by the FileDialog.
getFilenameFilter
public FilenameFilter getFilenameFilter()
- Returns
-
The current filename filter for the FileDialog.
getMode
public int getMode()
- Returns
-
The current mode of the FileDialog.
setDirectory
public synchronized void setDirectory (String directory)
- Parameters
-
- directory
-
Directory to be displayed by the FileDialog.
- directory
- Description
-
Changes the directory displayed in the FileDialog.
setFile
public synchronized void setFile (String file)
- Parameters
-
- file
-
Initial file string for FileDialog.
- file
- Description
-
Change the default file selected by the FileDialog.
setFilenameFilter
public synchronized void setFilenameFilter (FilenameFilter filter)
- Parameters
-
- filter
-
Initial filter for FileDialog.
- filter
- Description
-
Changes the current filename filter of the FileDialog.
setMode
public void setMode (int mode)
- Parameters
-
- mode
-
The constant LOAD or SAVE, specifying the dialog's mode.
- mode
- Description
-
Change the mode of the file dialog.
Protected Instance Methods
paramString
protected String paramString()
- Returns
-
String with current settings of FileDialog.
- Overrides
-
Dialog.paramString()
- Description
-
Helper method for toString() to generate string of current settings.
See Also
Dialog, FilenameFilter, String
|
 |
|
| EventQueue |
 |
FlowLayout |
