java.awt

Класс FileDialog

java.lang. Объект

java.awt. Компонент

java.awt. Контейнер

java.awt. Окно

java.awt. Диалоговое окно

java.awt. FileDialog

Все Реализованные Интерфейсы:

ImageObserver, MenuContainer, Сериализуемый, Доступный

public class FileDialog
extends Dialog

FileDialog class выводит на экран диалоговое окно, из которого пользователь может выбрать файл.

Так как это - модальное диалоговое окно, когда приложение вызывает show метод, чтобы вывести на экран диалоговое окно, это блокирует остальную часть приложения, пока пользователь не выбрал файл.

С тех пор:

JDK1.0

См. Также:

Window.show(), Сериализированная Форма

Вложенная Сводка Класса

Вложенные классы/интерфейсы, наследованные от class java.awt. Диалоговое окно

Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType

Вложенные классы/интерфейсы, наследованные от class java.awt. Окно

Window.AccessibleAWTWindow, Window.Type

Вложенные классы/интерфейсы, наследованные от class java.awt. Контейнер

Контейнер. AccessibleAWTContainer

Вложенные классы/интерфейсы, наследованные от class java.awt. Компонент

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
static int	ЗАГРУЗКА Эта постоянная величина указывает, что цель диалогового окна файла состоит в том, чтобы определить местоположение файла, из которого можно читать.
static int	СОХРАНИТЬ Эта постоянная величина указывает, что цель диалогового окна файла состоит в том, чтобы определить местоположение файла, в который можно записать.

Поля, наследованные от class java.awt. Диалоговое окно

DEFAULT_MODALITY_TYPE

Поля, наследованные от class java.awt. Компонент

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, наследованные от интерфейса java.awt.image. ImageObserver

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

Сводка конструктора

Конструкторы

Конструктор и Описание
FileDialog(Dialog parent) Создает диалоговое окно файла для того, чтобы загрузить файл.
FileDialog(Dialog parent, String title) Создает диалоговое окно файла с указанным title для того, чтобы загрузить файл.
FileDialog(Dialog parent, String title, int mode) Создает диалоговое окно файла с указанным title для того, чтобы загрузить или сохранить файл.
FileDialog(Frame parent) Создает диалоговое окно файла для того, чтобы загрузить файл.
FileDialog(Frame parent, String title) Создает диалоговое окно файла с указанным title для того, чтобы загрузить файл.
FileDialog(Frame parent, String title, int mode) Создает диалоговое окно файла с указанным title для того, чтобы загрузить или сохранить файл.

Сводка метода

Модификатор и Тип	Метод и Описание
void	addNotify() Создает диалоговую коллегу файла.
Строка	getDirectory() Получает каталог этого диалогового окна файла.
Строка	getFile() Получает выбранный файл этого диалогового окна файла.
FilenameFilter	getFilenameFilter() Определяет этот диалоговый фильтр имени файла файла.
Файл[]	getFiles() Файлы возвратов, которые выбирает пользователь.
int	getMode() Указывает, является ли это диалоговое окно файла для того, чтобы загрузиться от файла или для того, чтобы сохранить к файлу.
boolean	isMultipleMode() Возвраты, позволяет ли диалоговое окно файла многократный выбор файла.
protected String	paramString() Возвращает строку, представляющую состояние этого FileDialog окно.
void	setDirectory(String dir) Устанавливает каталог этого диалогового окна файла, чтобы быть указанным каталогом.
void	setFile(String file) Устанавливает выбранный файл для этого диалогового окна файла, чтобы быть указанным файлом.
void	setFilenameFilter(FilenameFilter filter) Устанавливает фильтр имени файла для этого диалогового окна файла к указанному фильтру.
void	setMode(int mode) Устанавливает режим диалогового окна файла.
void	setMultipleMode(boolean enable) Включает или отключает многократный выбор файла для диалогового окна файла.

Методы, наследованные от class java.awt. Диалоговое окно

getAccessibleContext, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, setUndecorated, setVisible, show, toBack

Методы, наследованные от class java.awt. Окно

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, toFront

Методы, наследованные от class java.awt. Контейнер

add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTree

Методы, наследованные от class java.awt. Компонент

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Полевая Деталь

ЗАГРУЗКА

public static final int LOAD

Эта постоянная величина указывает, что цель диалогового окна файла состоит в том, чтобы определить местоположение файла, из которого можно читать.

См. Также:

Постоянные Значения полей

СОХРАНИТЬ

public static final int SAVE

Эта постоянная величина указывает, что цель диалогового окна файла состоит в том, чтобы определить местоположение файла, в который можно записать.

См. Также:

Постоянные Значения полей

Деталь конструктора

FileDialog

public FileDialog(Frame parent)

Создает диалоговое окно файла для того, чтобы загрузить файл. title диалогового окна файла первоначально пуст. Это - метод удобства для FileDialog(parent, "", LOAD).

Параметры:

parent - владелец диалогового окна

С тех пор:

JDK1.1

FileDialog

public FileDialog(Frame parent,
                  String title)

Создает диалоговое окно файла с указанным title для того, чтобы загрузить файл. Показанные файлы являются теми в текущем каталоге. Это - метод удобства для FileDialog(parent, title, LOAD).

Параметры:

parent - владелец диалогового окна

title - title диалогового окна

FileDialog

public FileDialog(Frame parent,
                  String title,
                  int mode)

Создает диалоговое окно файла с указанным title для того, чтобы загрузить или сохранить файл.

Если значение mode LOAD, тогда диалоговое окно файла находит, что файл читает, и показанные файлы являются теми в текущем каталоге. Если значение mode SAVE, диалоговое окно файла находит, что место пишет файл.

Параметры:

parent - владелец диалогового окна

title - title диалогового окна

mode - режим диалогового окна; также FileDialog.LOAD или FileDialog.SAVE

Броски:

IllegalArgumentException - если недопустимый диалоговый режим файла предоставляется

См. Также:

LOAD, SAVE

FileDialog

public FileDialog(Dialog parent)

Создает диалоговое окно файла для того, чтобы загрузить файл. title диалогового окна файла первоначально пуст. Это - метод удобства для FileDialog(parent, "", LOAD).

Параметры:

parent - владелец диалогового окна

Броски:

IllegalArgumentException - если parent's GraphicsConfiguration не от экранного устройства;

IllegalArgumentException - если parent null; это исключение всегда выдается когда GraphicsEnvironment.isHeadless возвраты true

С тех пор:

1.5

См. Также:

GraphicsEnvironment.isHeadless()

FileDialog

public FileDialog(Dialog parent,
                  String title)

Создает диалоговое окно файла с указанным title для того, чтобы загрузить файл. Показанные файлы являются теми в текущем каталоге. Это - метод удобства для FileDialog(parent, title, LOAD).

Параметры:

parent - владелец диалогового окна

title - title диалогового окна; a null значение будет принято, не вызывая a NullPointerException быть брошенным

Броски:

IllegalArgumentException - если parent's GraphicsConfiguration не от экранного устройства;

IllegalArgumentException - если parent null; это исключение всегда выдается когда GraphicsEnvironment.isHeadless возвраты true

С тех пор:

1.5

См. Также:

GraphicsEnvironment.isHeadless()

FileDialog

public FileDialog(Dialog parent,
                  String title,
                  int mode)

Создает диалоговое окно файла с указанным title для того, чтобы загрузить или сохранить файл.

Если значение mode LOAD, тогда диалоговое окно файла находит, что файл читает, и показанные файлы являются теми в текущем каталоге. Если значение mode SAVE, диалоговое окно файла находит, что место пишет файл.

Параметры:

parent - владелец диалогового окна

title - title диалогового окна; a null значение будет принято, не вызывая a NullPointerException быть брошенным

mode - режим диалогового окна; также FileDialog.LOAD или FileDialog.SAVE

Броски:

IllegalArgumentException - если недопустимый диалоговый режим файла предоставляется;

IllegalArgumentException - если parent's GraphicsConfiguration не от экранного устройства;

IllegalArgumentException - если parent null; это исключение всегда выдается когда GraphicsEnvironment.isHeadless возвраты true

С тех пор:

1.5

См. Также:

GraphicsEnvironment.isHeadless(), LOAD, SAVE

Деталь метода

addNotify

public void addNotify()

Создает диалоговую коллегу файла. Коллега позволяет нам изменять вид диалогового окна файла, не изменяя его функциональность.

Переопределения:

addNotify в class Dialog

См. Также:

Component.isDisplayable(), Window.removeNotify()

getMode

public int getMode()

Указывает, является ли это диалоговое окно файла для того, чтобы загрузиться от файла или для того, чтобы сохранить к файлу.

Возвраты:

режим этого диалогового окна файла, также FileDialog.LOAD или FileDialog.SAVE

См. Также:

LOAD, SAVE, setMode(int)

setMode

public void setMode(int mode)

Устанавливает режим диалогового окна файла. Если mode не юридическое значение, исключение будет выдано и mode не будет установлен.

Параметры:

mode - режим для этого диалогового окна файла, также FileDialog.LOAD или FileDialog.SAVE

Броски:

IllegalArgumentException - если недопустимый диалоговый режим файла предоставляется

С тех пор:

JDK1.1

См. Также:

LOAD, SAVE, getMode()

getDirectory

public String getDirectory()

Получает каталог этого диалогового окна файла.

Возвраты:

(потенциально null или недопустимый) каталог этого FileDialog

См. Также:

setDirectory(java.lang.String)

setDirectory

public void setDirectory(String dir)

Устанавливает каталог этого диалогового окна файла, чтобы быть указанным каталогом. Определение a null или недопустимый каталог подразумевает определенное с помощью реализации значение по умолчанию. Это значение по умолчанию не будет понято, однако, пока пользователь не выбрал файл. До этой точки, getDirectory() возвратит значение, которое передают в этот метод.

Определяя, "" поскольку каталог точно эквивалентен определению null как каталог.

Параметры:

dir - указанный каталог

См. Также:

getDirectory()

getFile

public String getFile()

Получает выбранный файл этого диалогового окна файла. Если пользователь выбирается CANCEL, возвращенный файл null.

Возвраты:

в настоящий момент выбранный файл этого диалогового окна файла, или null если ни один не выбирается

См. Также:

setFile(java.lang.String)

getFiles

public File[] getFiles()

Файлы возвратов, которые выбирает пользователь.

Если пользователь отменяет диалоговое окно файла, то метод возвращает пустой массив.

Возвраты:

файлы, которые пользователь выбирает или пустой массив, если пользователь отменяет диалоговое окно файла.

С тех пор:

1.7

См. Также:

setFile(String), getFile()

setFile

public void setFile(String file)

Устанавливает выбранный файл для этого диалогового окна файла, чтобы быть указанным файлом. Этот файл становится файлом значения по умолчанию, если это устанавливается прежде, чем диалоговое окно файла сначала показывают.

Определяя, "" поскольку файл точно эквивалентен определению null как файл.

Параметры:

file - устанавливаемый файл

См. Также:

getFile(), getFiles()

setMultipleMode

public void setMultipleMode(boolean enable)

Включает или отключает многократный выбор файла для диалогового окна файла.

Параметры:

enable - если true, многократный выбор файла включается; false - отключенный.

С тех пор:

1.7

См. Также:

isMultipleMode()

isMultipleMode

public boolean isMultipleMode()

Возвраты, позволяет ли диалоговое окно файла многократный выбор файла.

Возвраты:

true если диалоговое окно файла позволяет многократный выбор файла; false иначе.

С тех пор:

1.7

См. Также:

setMultipleMode(boolean)

getFilenameFilter

public FilenameFilter getFilenameFilter()

Определяет этот диалоговый фильтр имени файла файла. Фильтр имени файла позволяет пользователю определять, какие файлы появляются в диалоговом окне файла. Фильтры имени файла не функционируют в ссылочной реализации Sun для Microsoft Windows.

Возвраты:

этот диалоговый фильтр имени файла файла

См. Также:

FilenameFilter, setFilenameFilter(java.io.FilenameFilter)

setFilenameFilter

public void setFilenameFilter(FilenameFilter filter)

Устанавливает фильтр имени файла для этого диалогового окна файла к указанному фильтру. Фильтры имени файла не функционируют в ссылочной реализации Sun для Microsoft Windows.

Параметры:

filter - указанный фильтр

См. Также:

FilenameFilter, getFilenameFilter()

paramString

protected String paramString()

Возвращает строку, представляющую состояние этого FileDialog окно. Этот метод предназначается, чтобы использоваться только для того, чтобы отладить цели, и контент и формат возвращенной строки могут измениться между реализациями. Возвращенная строка может быть пустой, но, возможно, не null.

Переопределения:

paramString в class Dialog

Возвраты:

строка параметра этого диалогового окна файла