Класс FileDialog

java.awt.FileDialog

Все реализованные интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible

public class FileDialog extends Dialog

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

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

Начиная с:

1.0

См. также:

Краткое описание вложенных классов

Вложенные классы и интерфейсы, объявленные в классе Dialog

Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType

Вложенные классы и интерфейсы, объявленные в классе Window

Window.AccessibleAWTWindow, Window.Type

Вложенные классы и интерфейсы, объявленные в классе Container

Container.AccessibleAWTContainer

Вложенные классы и интерфейсы, объявленные в классе Component

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

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`LOAD`	Это значение константы указывает, что диалоговое окно предназначено для поиска файла, из которого нужно прочитать данные.
`static final int`	`SAVE`	Это значение константы указывает, что диалоговое окно предназначено для поиска файла, в который нужно записать данные.

Поля, объявленные в классе Dialog

DEFAULT_MODALITY_TYPE

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе ImageObserver

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

Краткое описание конструкторов

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

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addNotify()`	Создает peer-объект диалогового окна.
`String`	`getDirectory()`	Возвращает каталог этого диалогового окна.
`String`	`getFile()`	Возвращает выбранный файл этого диалогового окна.
`FilenameFilter`	`getFilenameFilter()`	Возвращает фильтр имен файлов этого диалогового окна.
`File[]`	`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)`	Включает или отключает выбор нескольких файлов в диалоговом окне.
`void`	`setTitle(String title)`	Устанавливает заголовок диалогового окна.

Методы, объявленные в классе Dialog

getAccessibleContext, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setModalityType, setResizable, setUndecorated, setVisible, show, toBack

Методы, объявленные в классе Window

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, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBackground, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setOpacity, setShape, setSize, setSize, setType, toFront

Методы, объявленные в классе Container

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, removeNotify, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTree

Методы, объявленные в классе Component

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, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, объявленные в классе Object

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

Подробное описание полей

LOAD

@Native public static final int LOAD

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

См. также:

SAVE

@Native public static final int SAVE

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

См. также:

Подробное описание конструкторов

FileDialog

public FileDialog(Frame parent)

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

Примечание: Некоторые платформы могут не поддерживать отображение указанного пользователем заголовка в диалоговом окне. В этом случае в строке заголовка диалогового окна заголовок не отображается либо, в некоторых системах, не отображается сама строка заголовка.

Параметры:: parent — владелец диалогового окна
Начиная с:: 1.1

FileDialog

public FileDialog(Frame parent, String title)

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

Параметры:: parent — владелец диалогового окна; title — заголовок диалогового окна

FileDialog

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

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

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

Параметры:

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

title — заголовок диалогового окна

mode — режим диалогового окна: FileDialog.LOAD или FileDialog.SAVE

Исключения:

IllegalArgumentException — если задан недопустимый режим диалогового окна

См. также:

FileDialog

public FileDialog(Dialog parent)

Параметры:

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

Исключения:

IllegalArgumentException — если parent's GraphicsConfiguration не является устройством отображения;

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

Начиная с:

1.5

См. также:

FileDialog

public FileDialog(Dialog parent, String title)

Параметры:

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

title — заголовок диалогового окна; значение null принимается без выбрасывания NullPointerException

Исключения:

IllegalArgumentException — если parent's GraphicsConfiguration не является устройством отображения;

Начиная с:

1.5

См. также:

FileDialog

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

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

Параметры:

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

title — заголовок диалогового окна; значение null принимается без выбрасывания NullPointerException

mode — режим диалогового окна: FileDialog.LOAD или FileDialog.SAVE

Исключения:

IllegalArgumentException — если задан недопустимый режим диалогового окна;

IllegalArgumentException — если parent's GraphicsConfiguration не является устройством отображения;

Начиная с:

1.5

См. также:

Подробное описание методов

setTitle

public void setTitle(String title)

Устанавливает заголовок диалогового окна.

Переопределяет:

setTitle в классе Dialog

Параметры:

title — заголовок, отображаемый в рамке диалогового окна; значение null задает пустой заголовок

См. также:

addNotify

public void addNotify()

Создает peer-объект диалогового окна. Peer-объект позволяет изменить внешний вид диалогового окна, не меняя его функциональность.

Переопределяет:

addNotify в классе Dialog

См. также:

getMode

public int getMode()

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

Возвращает:

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

См. также:

setMode

public void setMode(int mode)

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

Параметры:

mode — режим этого диалогового окна: FileDialog.LOAD или FileDialog.SAVE

Исключения:

IllegalArgumentException — если задан недопустимый режим диалогового окна

Начиная с:

1.1

См. также:

getDirectory

public String getDirectory()

Возвращает каталог этого диалогового окна.

Возвращает:

каталог этого FileDialog (возможно, null или недопустимый)

См. также:

setDirectory

public void setDirectory(String dir)

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

Указание "" в качестве каталога полностью эквивалентно указанию null в качестве каталога.

Параметры:

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

См. также:

getFile

public String getFile()

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

Возвращает:

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

См. также:

getFiles

public File[] getFiles()

Возвращает файлы, выбранные пользователем.

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

Возвращает:

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

Начиная с:

1.7

См. также:

setFile

public void setFile(String file)

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

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

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

Указание "" в качестве файла полностью эквивалентно указанию null в качестве файла.

Параметры:

file — задаваемый файл

См. также:

setMultipleMode

public void setMultipleMode(boolean enable)

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

Параметры:

enable — если true, выбор нескольких файлов включен; false — отключен.

Начиная с:

1.7

См. также:

isMultipleMode

public boolean isMultipleMode()

Возвращает, разрешен ли в диалоговом окне выбор нескольких файлов.

Возвращает:

true, если в диалоговом окне разрешен выбор нескольких файлов; в противном случае — false.

Начиная с:

1.7

См. также:

getFilenameFilter

public FilenameFilter getFilenameFilter()

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

Возвращает:

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

См. также:

setFilenameFilter

public void setFilenameFilter(FilenameFilter filter)

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

Параметры:

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

См. также:

paramString

protected String paramString()

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

Переопределяет:: paramString в классе Dialog
Возвращает:: строку параметров этого диалогового окна

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/FileDialog.html