Класс 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

public static final int LOAD

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

См. также:

SAVE

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 GraphicsConfiguration не принадлежит экранному устройству;

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

С версии:

1.5

См. также:

FileDialog

public FileDialog(Dialog parent, String title)

Параметры:

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

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

Исключения:

IllegalArgumentException - если parent GraphicsConfiguration не принадлежит экранному устройству;

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

С версии:

1.5

См. также:

FileDialog

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

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

Параметры:

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

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

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

Исключения:

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

IllegalArgumentException - если parent GraphicsConfiguration не принадлежит экранному устройству;

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

С версии:

1.5

См. также:

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

setTitle

public void setTitle(String title)

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

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

setTitle в классе Dialog

Параметры:

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

См. также:

addNotify

public void addNotify()

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

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

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 в качестве каталога.

Parameters:

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

See Also:

getFile

public String getFile()

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

Returns:

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

See Also:

getFiles

public File[] getFiles()

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

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

Returns:

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

Since:

1.7

See Also:

setFile

public void setFile(String file)

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

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

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

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

Parameters:

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

See Also:

setMultipleMode

public void setMultipleMode(boolean enable)

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

Parameters:

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

Since:

1.7

See Also:

isMultipleMode

public boolean isMultipleMode()

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

Returns:

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

Since:

1.7

See Also:

getFilenameFilter

public FilenameFilter getFilenameFilter()

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

Returns:

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

See Also:

setFilenameFilter

public void setFilenameFilter(FilenameFilter filter)

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

Parameters:

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

See Also:

paramString

protected String paramString()

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

Overrides:: paramString в классе Dialog
Returns:: строка параметров этого окна диалога выбора файла

© 1993, 2023, 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/21/docs/api/java.desktop/java/awt/FileDialog.html