Класс FileDialog

java.awt.FileDialog

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

public class FileDialog extends Dialog

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

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

С тех пор:

1.0

См. также:

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

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

Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType

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

Window.AccessibleAWTWindow, Window.Type

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

Container.AccessibleAWTContainer

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

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

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

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

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

DEFAULT_MODALITY_TYPE

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

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)`	Создаёт диалоговое окно с указанным заголовком для загрузки файла.
`FileDialog(Dialog parent, String title, int mode)`	Создаёт диалоговое окно с указанным заголовком для загрузки или сохранения файла.
`FileDialog(Frame parent)`	Создаёт диалоговое окно для загрузки файла.
`FileDialog(Frame parent, String title)`	Создаёт диалоговое окно с указанным заголовком для загрузки файла.
`FileDialog(Frame parent, String title, int mode)`	Создаёт диалоговое окно с указанным заголовком для загрузки или сохранения файла.

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

Модификатор и тип	Метод	Описание
`void`	`addNotify()`	Создаёт виджет диалогового окна.
`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)`	Устанавливает заголовок диалогового окна.

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

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

Методы, объявленные в классе java.awt.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

Методы, объявленные в классе java.awt.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

Методы, объявленные в классе java.awt.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

Методы, объявленные в классе java.lang.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()

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

Возвращает:

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

См. также:

setDirectory

public void setDirectory(String dir)

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

Указание "" в качестве директории эквивалентно указанию null в качестве директории.

Параметры:

dir - указанная директория

См. также:

getFile

public String getFile()

Получает выбранный файл из этого диалогового окна для выбора файла. Если пользователь отменил выбор, возвращаемый файл 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/FileDialog.html