java.awt

Class FileDialog

Implemented Interfaces:
Accessible, ImageObserver, MenuContainer, Serializable

public class FileDialog
extends Dialog
implements Serializable

This class implements a file selection dialog box widget.
See Also:
Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.awt.Dialog

Dialog.AccessibleAWTDialog

Nested classes/interfaces inherited from class java.awt.Window

Window.AccessibleAWTWindow

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

static int
LOAD
Indicates that the purpose of the dialog is for opening a file.
static int
SAVE
Indicates that the purpose of the dialog is for saving a file.

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

FileDialog(Dialog parent)
Initializes a new instance of FileDialog with the specified parent.
FileDialog(Dialog parent, String title)
Initialized a new instance of FileDialog with the specified parent and title.
FileDialog(Dialog parent, String title, int mode)
Initialized a new instance of FileDialog with the specified parent, title, and mode.
FileDialog(Frame parent)
Initializes a new instance of FileDialog with the specified parent.
FileDialog(Frame parent, String title)
Initialized a new instance of FileDialog with the specified parent and title.
FileDialog(Frame parent, String title, int mode)
Initialized a new instance of FileDialog with the specified parent, title, and mode.

Method Summary

void
addNotify()
Creates the native peer for this file dialog box.
String
getDirectory()
Returns the directory for this file dialog.
String
getFile()
Returns the file that is selected in this dialog.
FilenameFilter
getFilenameFilter()
Returns the filename filter being used by this dialog.
int
getMode()
Returns the mode of this dialog, either LOAD or SAVE.
protected String
paramString()
Returns a debugging string for this object.
void
setDirectory(String dir)
Sets the directory for this file dialog.
void
setFile(String file)
Sets the selected file for this dialog.
void
setFilenameFilter(FilenameFilter filter)
Sets the filename filter used by this dialog.
void
setMode(int mode)
Sets the mode of this dialog to either LOAD or SAVE.

Methods inherited from class java.awt.Dialog

addNotify, dispose, getAccessibleContext, getTitle, hide, isModal, isResizable, isUndecorated, paramString, setModal, setResizable, setTitle, setUndecorated, show

Methods inherited from class java.awt.Window

addNotify, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, extends EventListener> T[] getListeners, getAccessibleContext, getBufferStrategy, getFocusCycleRootAncestor, getFocusOwner, getFocusableWindowState, getGraphicsConfiguration, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, isActive, isAlwaysOnTop, isFocusCycleRoot, isFocusableWindow, isFocused, isShowing, pack, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setAlwaysOnTop, setCursor, setFocusCycleRoot, setFocusableWindowState, setLocationRelativeTo, toBack, toFront, void hide, void show

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, extends EventListener> T[] getListeners, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponentZOrder, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, extends EventListener> T[] getListeners, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getAlignmentX, getAlignmentY, getBackground, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFocusable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, paramString, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFocusable, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

LOAD

public static final int LOAD
Indicates that the purpose of the dialog is for opening a file.
Field Value:
0

SAVE

public static final int SAVE
Indicates that the purpose of the dialog is for saving a file.
Field Value:
1

Constructor Details

FileDialog

public FileDialog(Dialog parent)
Initializes a new instance of FileDialog with the specified parent. This dialog will have no title and will be for loading a file.
Parameters:
parent - The parent dialog for this.
Since:
1.5

FileDialog

public FileDialog(Dialog parent,
                  String title)
Initialized a new instance of FileDialog with the specified parent and title. This dialog will be for opening a file.
Parameters:
parent - The parent dialog for this.
title - The title for this dialog.
Since:
1.5

FileDialog

public FileDialog(Dialog parent,
                  String title,
                  int mode)
Initialized a new instance of FileDialog with the specified parent, title, and mode.
Parameters:
parent - The parent dialog for this.
title - The title for this dialog.
mode - The mode of the dialog, either LOAD or SAVE.
Throws:
IllegalArgumentException - - if illegal mode, if GraphicsEnvironment.isHeadless or if parent is null.
Since:
1.5

FileDialog

public FileDialog(Frame parent)
Initializes a new instance of FileDialog with the specified parent. This dialog will have no title and will be for loading a file.
Parameters:
parent - The parent frame for this dialog.

FileDialog

public FileDialog(Frame parent,
                  String title)
Initialized a new instance of FileDialog with the specified parent and title. This dialog will be for opening a file.
Parameters:
parent - The parent frame for this dialog.
title - The title for this dialog.

FileDialog

public FileDialog(Frame parent,
                  String title,
                  int mode)
Initialized a new instance of FileDialog with the specified parent, title, and mode.
Parameters:
parent - The parent frame for this dialog.
title - The title for this dialog.
mode - The mode of the dialog, either LOAD or SAVE.
Throws:
IllegalArgumentException - If an illegal file dialog mode is supplied.

Method Details

addNotify

public void addNotify()
Creates the native peer for this file dialog box.
Overrides:
addNotify in interface Dialog

getDirectory

public String getDirectory()
Returns the directory for this file dialog.
Returns:
The directory for this file dialog.

getFile

public String getFile()
Returns the file that is selected in this dialog.
Returns:
The file that is selected in this dialog.

getFilenameFilter

public FilenameFilter getFilenameFilter()
Returns the filename filter being used by this dialog.
Returns:
The filename filter being used by this dialog.

getMode

public int getMode()
Returns the mode of this dialog, either LOAD or SAVE.
Returns:
The mode of this dialog.

paramString

protected String paramString()
Returns a debugging string for this object.
Overrides:
paramString in interface Dialog
Returns:
A debugging string for this object.

setDirectory

public void setDirectory(String dir)
Sets the directory for this file dialog.
Parameters:
dir - The new directory for this file dialog.

setFile

public void setFile(String file)
Sets the selected file for this dialog.
Parameters:
file - The selected file for this dialog.

setFilenameFilter

public void setFilenameFilter(FilenameFilter filter)
Sets the filename filter used by this dialog.
Parameters:
filter - The new filename filter for this file dialog box.

setMode

public void setMode(int mode)
Sets the mode of this dialog to either LOAD or SAVE. This method is only effective before the native peer is created.
Parameters:
mode - The new mode of this file dialog.
Throws:
IllegalArgumentException - If an illegal file dialog mode is supplied.

FileDialog.java -- A filename selection dialog box Copyright (C) 1999, 2000, 2001, 2002, 2004, 2005 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.