Класс FileDialog

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - java.awt.Window
    - - java.awt.Dialog
      - java.awt.FileDialog

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

public class FileDialog
extends Dialog

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

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

С тех пор:: JDK1.0
См. также:: Window.show(), Сериализованная форма

Вложенные классы

Вложенные классы/интерфейсы, унаследованные от класса 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 int`	`LOAD` Это константное значение указывает, что назначение окна диалога выбора файла — найти файл для чтения.
`static 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)` Включает или выключает множественный выбор файлов для диалогового окна выбора файла.

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

getAccessibleContext, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, 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, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, 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, 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, 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

Методы, унаследованные от класса 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 — владелец диалогового окна
С:: JDK1.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 — если указан некорректный режим диалогового окна
См. также:: LOAD, SAVE

FileDialog

public FileDialog(Dialog parent)

Параметры:: parent — владелец диалогового окна
Исключения:: IllegalArgumentException — если parent's GraphicsConfiguration не из устройства экрана;; IllegalArgumentException — если parent равно null; это исключение всегда выбрасывается, когда GraphicsEnvironment.isHeadless возвращает true
С:: 1.5
См. также:: GraphicsEnvironment.isHeadless()

FileDialog

public FileDialog(Dialog parent,
                  String title)

Параметры:: parent — владелец диалогового окна; title — заголовок диалогового окна; значение null будет принято без выбрасывания NullPointerException
Исключения:: IllegalArgumentException — если parent's GraphicsConfiguration не из устройства экрана;; IllegalArgumentException — если parent равно null; это исключение всегда выбрасывается, когда GraphicsEnvironment.isHeadless возвращает true
С:: 1.5
См. также:: GraphicsEnvironment.isHeadless()

FileDialog

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

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

Параметры:: parent — владелец диалогового окна; title — заголовок диалогового окна; значение null будет принято без выбрасывания 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()

Создаёт визуальный представитель (peer) диалогового окна выбора файла. Визуальный представитель позволяет изменять вид диалогового окна без изменения его функциональности.

Переопределяет:: addNotify в классе 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 или недопустимую)
См. также:: setDirectory(java.lang.String)

setDirectory

public void setDirectory(String dir)

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

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

Параметры:: dir — указанная директория
См. также:: getDirectory()

getFile

public String getFile()

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

Возвращает:: текущий выбранный файл в этом диалоговом окне, или null если ничего не выбрано
См. также:: setFile(java.lang.String)

getFiles

public File[] getFiles()

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

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

Возвращает:: выбранные файлы или пустой массив, если пользователь отменил выбор в диалоговом окне выбора файла.
С:: 1.7
См. также:: setFile(String), getFile()

setFile

public void setFile(String file)

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

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

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

Указание "" в качестве файла точно эквивалентно указанию 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 в классе Dialog
Возвращает:: строку параметров этого диалогового окна выбора файла

© 1993, 2020, 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.