Класс JFileChooser

Все реализуемые интерфейсы:
ImageObserver, MenuContainer, Serializable, Accessible 
@JavaBean(defaultProperty="UI",
          description="A component which allows for the interactive selection of a file.")
public class JFileChooser
extends JComponent
implements Accessible

JFileChooser предоставляет простой механизм для выбора файла пользователем. Подробную информацию об использовании JFileChooser, см. Как использовать диалоги выбора файла в разделе Java Tutorial.

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

JFileChooser chooser = new JFileChooser();
    FileNameExtensionFilter filter = new FileNameExtensionFilter(
        "JPG & GIF Images", "jpg", "gif");
    chooser.setFileFilter(filter);
    int returnVal = chooser.showOpenDialog(parent);
    if(returnVal == JFileChooser.APPROVE_OPTION) {
       System.out.println("You chose to open this file: " +
            chooser.getSelectedFile().getName());
    }

Предупреждение: Swing не потокобезопасен. Дополнительную информацию см. в Политике многопоточности Swing.

С тех пор:
1.2
См. также:
Сериализованная форма

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

Модификатор и тип Класс Описание
protected class  JFileChooser.AccessibleJFileChooser

Этот класс реализует поддержку доступности для класса JFileChooser.

Вложенные классы/интерфейсы, объявленные в классе javax.swing.JComponent

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

Поля

Модификатор и тип Поле Описание
static String ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY

Указывает, используется ли фильтр AcceptAllFileFilter.
protected AccessibleContext accessibleContext

AccessibleContext, связанный с этим JFileChooser.
static String ACCESSORY_CHANGED_PROPERTY

Указывает, используется ли дополнительный компонент (например, для предварительного просмотра файлов).
static String APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY

Указывает изменение мнемоники кнопки подтверждения (да, ок).
static String APPROVE_BUTTON_TEXT_CHANGED_PROPERTY

Указывает изменение текста кнопки подтверждения (да, ок).
static String APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY

Указывает изменение подсказки для кнопки подтверждения (да, ок).
static int APPROVE_OPTION

Возвращаемое значение, если выбрано подтверждение (да, ок).
static String APPROVE_SELECTION

Инструкция для подтверждения текущего выбора (аналогично нажатию на да или ок).
static int CANCEL_OPTION

Возвращаемое значение, если выбран отмена.
static String CANCEL_SELECTION

Инструкция для отмены текущего выбора.
static String CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY

Указывает изменение списка предопределенных фильтров файлов, из которых может выбрать пользователь.
static String CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY

Инструкция для отображения кнопок управления.
static int CUSTOM_DIALOG

Значение типа, указывающее, что JFileChooser поддерживает операцию с файлом, заданную разработчиком.
static String DIALOG_TITLE_CHANGED_PROPERTY

Указывает изменение заголовка диалогового окна.
static String DIALOG_TYPE_CHANGED_PROPERTY

Указывает изменение типа отображаемых файлов (только файлы, только каталоги или и то, и другое).
static int DIRECTORIES_ONLY

Инструкция для отображения только каталогов.
static String DIRECTORY_CHANGED_PROPERTY

Указывает изменение директории пользователя.
static int ERROR_OPTION

Возвращаемое значение, если произошла ошибка.
static String FILE_FILTER_CHANGED_PROPERTY

Пользователь изменил тип отображаемых файлов.
static String FILE_HIDING_CHANGED_PROPERTY

Указывает изменение свойства отображения скрытых файлов.
static String FILE_SELECTION_MODE_CHANGED_PROPERTY

Указывает изменение типа выбора (одиночный, множественный и т.д.).
static String FILE_SYSTEM_VIEW_CHANGED_PROPERTY

Указывает, что используется другой объект для поиска доступных дисков в системе.
static String FILE_VIEW_CHANGED_PROPERTY

Указывает, что используется другой объект для получения информации о файлах.
static int FILES_AND_DIRECTORIES

Инструкция для отображения файлов и каталогов.
static int FILES_ONLY

Инструкция для отображения только файлов.
static String MULTI_SELECTION_ENABLED_CHANGED_PROPERTY

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

Значение типа, указывающее, что JFileChooser поддерживает операцию «Открыть» файла.
static int SAVE_DIALOG

Значение типа, указывающее, что JFileChooser поддерживает операцию «Сохранить» файла.
static String SELECTED_FILE_CHANGED_PROPERTY

Указывает изменение выбора пользователем одного файла.
static String SELECTED_FILES_CHANGED_PROPERTY

Указывает изменение выбора пользователем нескольких файлов.

Поля, объявленные в классе javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

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

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

Конструктор Описание
JFileChooser()

Создает JFileChooser, указывающий на стандартную директорию пользователя.
JFileChooser​(File currentDirectory)

Создаёт JFileChooser, используя заданный File в качестве пути.
JFileChooser​(File currentDirectory, FileSystemView fsv)

Создаёт JFileChooser, используя заданную текущую директорию и FileSystemView.
JFileChooser​(String currentDirectoryPath)

Создаёт JFileChooser, используя заданный путь.
JFileChooser​(String currentDirectoryPath, FileSystemView fsv)

Создаёт JFileChooser, используя заданный путь к текущей директории и FileSystemView.
JFileChooser​(FileSystemView fsv)

Создаёт JFileChooser, используя заданный FileSystemView.

Методы

Модификатор и тип Метод Описание
boolean accept​(File f)

Возвращает true, если файл должен быть отображен.
void addActionListener​(ActionListener l)

Добавляет ActionListener к файловому обозревателю.
void addChoosableFileFilter​(FileFilter filter)

Добавляет фильтр в список фильтров файлов, доступных для выбора пользователем.
void approveSelection()

Вызывается интерфейсом пользователя при нажатии пользователем кнопки «Подтвердить» (по умолчанию «Открыть» или «Сохранить»).
void cancelSelection()

Вызывается интерфейсом пользователя при нажатии пользователем кнопки «Отмена».
void changeToParentDirectory()

Изменяет текущую директорию на родительскую директорию.
protected JDialog createDialog​(Component parent)

Создает и возвращает новый JDialog с this, центрированным на parent в рамке parent.

void ensureFileIsVisible​(File f)

Убеждается, что указанный файл отображается и не скрыт.
protected void fireActionPerformed​(String command)

Уведомляет всех слушателей, которые проявили интерес к уведомлениям об этом типе события.
FileFilter getAcceptAllFileFilter()

Возвращает фильтр файлов AcceptAll.

AccessibleContext getAccessibleContext()

Возвращает AccessibleContext, связанный с этим JFileChooser.
JComponent getAccessory()

Возвращает вспомогательный компонент.
ActionListener[] getActionListeners()

Возвращает массив всех зарегистрированных слушателей событий для этого файлового обозревателя.
int getApproveButtonMnemonic()

Возвращает мнемонический символ кнопки «Подтвердить».
String getApproveButtonText()

Возвращает текст, используемый в ApproveButton в FileChooserUI.

String getApproveButtonToolTipText()

Возвращает текст всплывающей подсказки, используемый в ApproveButton.

FileFilter[] getChoosableFileFilters()

Возвращает список фильтров файлов, доступных для выбора пользователем.
boolean getControlButtonsAreShown()

Возвращает значение свойства controlButtonsAreShown.

File getCurrentDirectory()

Возвращает текущую директорию.
String getDescription​(File f)

Возвращает описание файла.
String getDialogTitle()

Возвращает строку, которая отображается в строке заголовка JFileChooser.

int getDialogType()

Возвращает тип этого диалогового окна.
boolean getDragEnabled()

Возвращает значение свойства dragEnabled.

FileFilter getFileFilter()

Возвращает выбранный в данный момент фильтр файлов.
int getFileSelectionMode()

Возвращает текущий режим выбора файлов.
FileSystemView getFileSystemView()

Возвращает представление файловой системы.
FileView getFileView()

Возвращает текущее представление файла.
Icon getIcon​(File f)

Возвращает значок для данного файла или типа файла в зависимости от системы.
String getName​(File f)

Возвращает имя файла.
File getSelectedFile()

Возвращает выбранный файл.
File[] getSelectedFiles()

Возвращает список выбранных файлов, если в файловом обозревателе разрешен множественный выбор.
String getTypeDescription​(File f)

Возвращает тип файла.
FileChooserUI getUI()

Получает объект пользовательского интерфейса, реализующий L&F для этого компонента.
String getUIClassID()

Возвращает строку, содержащую имя класса L&F, который отображает этот компонент.
boolean isAcceptAllFileFilterUsed()

Возвращает, используется ли AcceptAll FileFilter.
boolean isDirectorySelectionEnabled()

Удобный метод, определяющий, могут ли каталоги выбираться в зависимости от текущего режима выбора файлов.
boolean isFileHidingEnabled()

Возвращает true, если скрытые файлы не отображаются в файловом обозревателе; в противном случае возвращает false.
boolean isFileSelectionEnabled()

Удобный метод, определяющий, могут ли файлы выбираться в зависимости от текущего режима выбора файлов.
boolean isMultiSelectionEnabled()

Возвращает true, если можно выбрать несколько файлов.
boolean isTraversable​(File f)

Возвращает true, если файл (каталог) может быть посещен.
protected String paramString()

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

void removeActionListener​(ActionListener l)

Удаляет ActionListener из файлового обозревателя.
boolean removeChoosableFileFilter​(FileFilter f)

Удаляет фильтр из списка фильтров файлов, доступных для выбора пользователем.
void rescanCurrentDirectory()

Уведомляет интерфейс пользователя о необходимости повторной проверки списка файлов в текущей директории.
void resetChoosableFileFilters()

Сбрасывает список фильтров файлов до начального состояния.
void setAcceptAllFileFilterUsed​(boolean b)

Определяет, используется ли AcceptAll FileFilter в качестве доступного варианта в списке фильтров.
void setAccessory​(JComponent newAccessory)

Устанавливает вспомогательный компонент.
void setApproveButtonMnemonic​(char mnemonic)

Устанавливает мнемонический символ кнопки «Подтвердить» с использованием символа.
void setApproveButtonMnemonic​(int mnemonic)

Устанавливает мнемонический символ кнопки «Подтвердить» с использованием цифрового кода.
void setApproveButtonText​(String approveButtonText)

Устанавливает текст, используемый в ApproveButton в FileChooserUI.

void setApproveButtonToolTipText​(String toolTipText)

Устанавливает текст всплывающей подсказки, используемый в ApproveButton.

void setControlButtonsAreShown​(boolean b)

Устанавливает свойство, указывающее, отображаются ли кнопки «Подтвердить» и «Отмена» в файловом обозревателе.
void setCurrentDirectory​(File dir)

Устанавливает текущую директорию.
void setDialogTitle​(String dialogTitle)

Устанавливает строку, отображаемую в строке заголовка окна JFileChooser.

void setDialogType​(int dialogType)

Устанавливает тип этого диалогового окна.
void setDragEnabled​(boolean b)

Устанавливает свойство dragEnabled, которое должно быть true, чтобы включить автоматическую обработку перетаскивания (первая часть перетаскивания и перемещения) на этом компоненте.
void setFileFilter​(FileFilter filter)

Устанавливает текущий фильтр файлов.
void setFileHidingEnabled​(boolean b)

Устанавливает скрытие файлов включенным или выключенным.
void setFileSelectionMode​(int mode)

Устанавливает JFileChooser для выбора только файлов, только каталогов или и файлов, и каталогов.
void setFileSystemView​(FileSystemView fsv)

Устанавливает представление файловой системы, которое JFileChooser использует для доступа к файловым ресурсам и их создания, например, для поиска дисковода гибких дисков и получения списка корневых дисков.
void setFileView​(FileView fileView)

Устанавливает представление файла, используемое для получения информации пользовательского интерфейса, например, значка, представляющего файл, или описания типа файла.
void setMultiSelectionEnabled​(boolean b)

Устанавливает разрешение множественного выбора файлов в файловом обозревателе.
void setSelectedFile​(File file)

Устанавливает выбранный файл.
void setSelectedFiles​(File[] selectedFiles)

Устанавливает список выбранных файлов, если диалог выбора файла разрешает множественный выбор.
void setSelectedFiles​(File[] selectedFiles)

Выполняет общую инициализацию и настройку конструктора.
int showDialog​(Component parent, String approveButtonText)

Выводит пользовательский диалог выбора файла с настраиваемой кнопкой подтверждения.
int showOpenDialog​(Component parent)

Выводит диалог выбора файла «Открыть файл».
int showSaveDialog​(Component parent)

Выводит диалог выбора файла «Сохранить файл».
void updateUI()

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

Методы, объявленные в классе javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

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

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

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

Поля

OPEN_DIALOG

public static final int OPEN_DIALOG

Значение типа, указывающее, что JFileChooser поддерживает операцию открытия файла.

См. также:
Значения постоянных полей

SAVE_DIALOG

public static final int SAVE_DIALOG

Значение типа, указывающее, что JFileChooser поддерживает операцию сохранения файла.

См. также:
Значения постоянных полей

CUSTOM_DIALOG

public static final int CUSTOM_DIALOG

Значение типа, указывающее, что JFileChooser поддерживает операцию работы с файлом, заданную разработчиком.

См. также:
Значения постоянных полей

CANCEL_OPTION

public static final int CANCEL_OPTION

Возвращаемое значение, если выбрана отмена.

См. также:
Значения постоянных полей

APPROVE_OPTION

public static final int APPROVE_OPTION

Возвращаемое значение, если выбрано подтверждение (да, ок).

См. также:
Значения постоянных полей

ERROR_OPTION

public static final int ERROR_OPTION

Возвращаемое значение, если произошла ошибка.

См. также:
Значения постоянных полей

FILES_ONLY

public static final int FILES_ONLY

Инструкция отображать только файлы.

См. также:
Значения постоянных полей

DIRECTORIES_ONLY

public static final int DIRECTORIES_ONLY

Инструкция отображать только каталоги.

См. также:
Значения постоянных полей

FILES_AND_DIRECTORIES

public static final int FILES_AND_DIRECTORIES

Инструкция отображать как файлы, так и каталоги.

См. также:
Значения постоянных полей

CANCEL_SELECTION

public static final String CANCEL_SELECTION

Инструкция отменить текущий выбор.

См. также:
Значения постоянных полей

APPROVE_SELECTION

public static final String APPROVE_SELECTION

Инструкция подтвердить текущий выбор (аналогично нажатию "да" или "ок").

См. также:
Значения постоянных полей

APPROVE_BUTTON_TEXT_CHANGED_PROPERTY

public static final String APPROVE_BUTTON_TEXT_CHANGED_PROPERTY

Указывает на изменение текста кнопки подтверждения (да, ок).

См. также:
Значения постоянных полей

APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY

public static final String APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY

Указывает на изменение всплывающей подсказки для кнопки подтверждения (да, ок).

См. также:
Значения постоянных полей

APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY

public static final String APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY

Указывает на изменение сочетания клавиш для кнопки подтверждения (да, ок).

См. также:
Значения постоянных полей

CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY

public static final String CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY

Инструкция отобразить кнопки управления.

См. также:
Значения постоянных полей

DIRECTORY_CHANGED_PROPERTY

public static final String DIRECTORY_CHANGED_PROPERTY

Указывает на изменение каталога пользователем.

См. также:
Значения постоянных полей

SELECTED_FILE_CHANGED_PROPERTY

public static final String SELECTED_FILE_CHANGED_PROPERTY

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

См. также:
Значения постоянных полей

SELECTED_FILES_CHANGED_PROPERTY

public static final String SELECTED_FILES_CHANGED_PROPERTY

Указывает на изменение выбора нескольких файлов пользователем.

См. также:
Значения постоянных полей

MULTI_SELECTION_ENABLED_CHANGED_PROPERTY

public static final String MULTI_SELECTION_ENABLED_CHANGED_PROPERTY

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

См. также:
Значения постоянных полей

FILE_SYSTEM_VIEW_CHANGED_PROPERTY

public static final String FILE_SYSTEM_VIEW_CHANGED_PROPERTY

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

См. также:
Значения постоянных полей

FILE_VIEW_CHANGED_PROPERTY

public static final String FILE_VIEW_CHANGED_PROPERTY

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

См. также:
Значения постоянных полей

FILE_HIDING_CHANGED_PROPERTY

public static final String FILE_HIDING_CHANGED_PROPERTY

Указывает на изменение свойства отображения скрытых файлов.

См. также:
Значения постоянных полей

FILE_FILTER_CHANGED_PROPERTY

public static final String FILE_FILTER_CHANGED_PROPERTY

Пользователь изменил тип отображаемых файлов.

См. также:
Значения постоянных полей

FILE_SELECTION_MODE_CHANGED_PROPERTY

public static final String FILE_SELECTION_MODE_CHANGED_PROPERTY

Указывает на изменение типа выбора (один, несколько и т. д.).

См. также:
Значения постоянных полей

ACCESSORY_CHANGED_PROPERTY

public static final String ACCESSORY_CHANGED_PROPERTY

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

См. также:
Значения постоянных полей

ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY

public static final String ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY

Указывает, используется ли фильтр AcceptAllFileFilter.

См. также:
Значения постоянных полей

DIALOG_TITLE_CHANGED_PROPERTY

public static final String DIALOG_TITLE_CHANGED_PROPERTY

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

См. также:
Значения постоянных полей

DIALOG_TYPE_CHANGED_PROPERTY

public static final String DIALOG_TYPE_CHANGED_PROPERTY

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

См. также:
Значения постоянных полей

CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY

public static final String CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY

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

См. также:
Значения постоянных полей

accessibleContext

protected AccessibleContext accessibleContext

AccessibleContext для этого JFileChooser

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

JFileChooser

public JFileChooser()

Создаёт JFileChooser, указывающий на стандартный каталог пользователя. Этот стандартный каталог зависит от операционной системы. Обычно это папка «Мои документы» в Windows и домашний каталог пользователя в Unix.

JFileChooser

public JFileChooser(String currentDirectoryPath)

Создаёт JFileChooser, используя указанный путь. Передача строки null приводит к тому, что файловый выборщик указывает на стандартный каталог пользователя. Этот стандартный каталог зависит от операционной системы. Обычно это папка «Мои документы» в Windows и домашний каталог пользователя в Unix.

Параметры:
currentDirectoryPath - строка String, задающая путь к файлу или каталогу

JFileChooser

public JFileChooser(File currentDirectory)

Создаёт JFileChooser, используя указанный File в качестве пути. Передача файла null приводит к тому, что файловый выборщик указывает на стандартный каталог пользователя. Этот стандартный каталог зависит от операционной системы. Обычно это папка «Мои документы» в Windows и домашний каталог пользователя в Unix.

Параметры:
currentDirectory - объект File, задающий путь к файлу или каталогу

JFileChooser

public JFileChooser(FileSystemView fsv)

Создаёт JFileChooser, используя указанный FileSystemView.

Параметры:
fsv - объект FileSystemView

JFileChooser

public JFileChooser(File currentDirectory,
                    FileSystemView fsv)

Создаёт JFileChooser, используя заданный текущий каталог и FileSystemView.

Параметры:
currentDirectory - объект File, задающий путь к файлу или каталогу
fsv - объект FileSystemView

JFileChooser

public JFileChooser(String currentDirectoryPath,
                    FileSystemView fsv)

Создаёт JFileChooser, используя указанный путь к текущему каталогу и FileSystemView.

Параметры:
currentDirectoryPath - строка String, задающая путь к файлу или каталогу
fsv - объект FileSystemView

Методы

setup

protected void setup(FileSystemView view)

Выполняет общую инициализацию и настройку конструктора.

Параметры:
view - FileSystemView используемое для настройки

setDragEnabled

@BeanProperty(bound=false,
              description="determines whether automatic drag handling is enabled")
public void setDragEnabled(boolean b)

Устанавливает свойство dragEnabled, которое должно быть true, чтобы включить автоматическую обработку перетаскивания (первая часть перетаскивания и перемещения) для этого компонента. Свойство transferHandler должно быть установлено в ненулевое значение, чтобы перетаскивание имело какой-либо эффект. Значение свойства dragEnabled по умолчанию составляет false.

При включённой автоматической обработке перетаскивания большинство визуальных стилей начинают операцию перетаскивания и перемещения, когда пользователь нажимает на кнопку мыши над элементом, а затем перемещает мышь на несколько пикселей. Установка этого свойства в true может поэтому иметь тонкое влияние на поведение выбора.

Некоторые визуальные стили могут не поддерживать автоматическое перетаскивание и перемещение; они проигнорируют это свойство. Вы можете обойти такие визуальные стили, изменив компонент для прямого вызова метода exportAsDrag объекта TransferHandler.

Параметры:
b - значение для установки свойства dragEnabled
Исключения:
HeadlessException - если b равно true и GraphicsEnvironment.isHeadless() возвращает true
С тех пор:
1.4
См. также:
GraphicsEnvironment.isHeadless(), getDragEnabled(), JComponent.setTransferHandler(javax.swing.TransferHandler), TransferHandler

getDragEnabled

public boolean getDragEnabled()

Возвращает значение свойства dragEnabled.

Возвращает:
значение свойства dragEnabled
С тех пор:
1.4
См. также:
setDragEnabled(boolean)

getSelectedFile

public File getSelectedFile()

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

Возвращает:
выбранный файл
См. также:
setSelectedFile(java.io.File)

setSelectedFile

@BeanProperty(preferred=true)
public void setSelectedFile(File file)

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

Параметры:
file - выбранный файл
См. также:
getSelectedFile()

getSelectedFiles

public File[] getSelectedFiles()

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

Возвращает:
массив выбранных File

setSelectedFiles

@BeanProperty(description="The list of selected files if the chooser is in multiple selection mode.")
public void setSelectedFiles(File[] selectedFiles)

Устанавливает список выбранных файлов, если в файловом диалоге разрешен множественный выбор.

Параметры:
selectedFiles - массив File для выбора

getCurrentDirectory

public File getCurrentDirectory()

Возвращает текущую директорию.

Возвращает:
текущая директория
См. также:
setCurrentDirectory(java.io.File)

setCurrentDirectory

@BeanProperty(preferred=true,
              description="The directory that the JFileChooser is showing files of.")
public void setCurrentDirectory(File dir)

Устанавливает текущую директорию. Передача null устанавливает файловый диалог на указанную по умолчанию директорию пользователя. Эта директория зависит от операционной системы. Как правило, это папка «Мои документы» в Windows и домашняя директория пользователя в Unix. Если файл, переданный как currentDirectory, не является директорией, родительская директория файла будет использоваться в качестве текущей директории. Если родительская директория недоступна, то поиск будет продолжен вверх по дереву родительских директорий до тех пор, пока не будет найдена доступная директория или не будет достигнут корень файловой системы.

Параметры:
dir - текущая директория
См. также:
getCurrentDirectory()

changeToParentDirectory

public void changeToParentDirectory()

Изменяет директорию на родительскую текущей директории.

См. также:
getCurrentDirectory()

rescanCurrentDirectory

public void rescanCurrentDirectory()

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

ensureFileIsVisible

public void ensureFileIsVisible(File f)

Убеждается, что указанный файл отображается, а не скрыт.

Параметры:
f - объект File

showOpenDialog

public int showOpenDialog(Component parent)
                   throws HeadlessException

Выводит диалоговое окно выбора файла «Открыть файл». Обратите внимание, что текст, отображаемый на кнопке «ОК», определяется визуальным стилем.

Параметры:
parent - родительский компонент диалогового окна, может быть null; см. showDialog для подробностей
Возвращает:
состояние возврата файлового диалога при закрытии:
  • JFileChooser.CANCEL_OPTION
  • JFileChooser.APPROVE_OPTION
  • JFileChooser.ERROR_OPTION в случае ошибки или закрытия диалогового окна
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless(), showDialog(java.awt.Component, java.lang.String)

showSaveDialog

public int showSaveDialog(Component parent)
                   throws HeadlessException

Выводит диалоговое окно выбора файла «Сохранить файл». Обратите внимание, что текст, отображаемый на кнопке «ОК», определяется визуальным стилем.

Параметры:
parent - родительский компонент диалогового окна, может быть null; см. showDialog для подробностей
Возвращает:
состояние возврата файлового диалога при закрытии:
  • JFileChooser.CANCEL_OPTION
  • JFileChooser.APPROVE_OPTION
  • JFileChooser.ERROR_OPTION в случае ошибки или закрытия диалогового окна
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless(), showDialog(java.awt.Component, java.lang.String)

showDialog

public int showDialog(Component parent,
                      String approveButtonText)
               throws HeadlessException

Выводит пользовательский диалог выбора файла с настраиваемой кнопкой «ОК». Например, следующий код выводит диалог выбора файла с кнопкой «Запустить приложение» (вместо обычной кнопки «Сохранить» или «Открыть»): 

filechooser.showDialog(parentFrame, "Run Application");
Аналогично, следующий код делает то же самое: 
JFileChooser chooser = new JFileChooser(null);
    chooser.setApproveButtonText("Run Application");
    chooser.showDialog(parentFrame, null);

Аргумент parent определяет два параметра: фрейм, от которого зависит диалоговое окно, и компонент, положение которого визуальный стиль должен учитывать при размещении диалогового окна. Если родительский элемент является объектом Frame (например, JFrame), то диалоговое окно зависит от фрейма, а визуальный стиль размещает его относительно фрейма (например, по центру над фреймом). Если родительский элемент является компонентом, то диалоговое окно зависит от фрейма, содержащего компонент, и размещается относительно компонента (например, по центру над компонентом). Если родительский элемент является null, то диалоговое окно не зависит от видимого окна и размещается в зависимости от визуального стиля, например, в центре экрана.

Параметры:
parent - родительский компонент диалогового окна; может быть null
approveButtonText - текст кнопки «ОК»
Возвращает:
состояние возврата файлового диалога при закрытии:
  • JFileChooser.CANCEL_OPTION
  • JFileChooser.APPROVE_OPTION
  • JFileChooser.ERROR_OPTION в случае ошибки или закрытия диалогового окна
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless()

createDialog

protected JDialog createDialog(Component parent)
                        throws HeadlessException

Создаёт и возвращает новый JDialog, обертывающий this, центрированный на parent в фрейме parent. Этот метод можно переопределить, чтобы дополнительно манипулировать диалоговым окном, отключить изменение размера, установить расположение и т.д. Пример: 

class MyFileChooser extends JFileChooser {
         protected JDialog createDialog(Component parent) throws HeadlessException {
             JDialog dialog = super.createDialog(parent);
             dialog.setLocation(300, 200);
             dialog.setResizable(false);
             return dialog;
         }
     }

Параметры:
parent - родительский компонент диалогового окна; может быть null
Возвращает:
новый JDialog, содержащий этот экземпляр
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
С тех пор:
1.4
См. также:
GraphicsEnvironment.isHeadless()

getControlButtonsAreShown

public boolean getControlButtonsAreShown()

Возвращает значение свойства controlButtonsAreShown.

Возвращает:
значение свойства controlButtonsAreShown
С тех пор:
1.3
См. также:
setControlButtonsAreShown(boolean)

setControlButtonsAreShown

@BeanProperty(preferred=true,
              description="Sets whether the approve & cancel buttons are shown.")
public void setControlButtonsAreShown(boolean b)

Устанавливает свойство, указывающее, отображаются ли кнопки «ОК» и «Отмена» в файловом диалоге. По умолчанию это свойство true. Визуальные стили, которые всегда отображают эти кнопки, игнорируют значение этого свойства. Этот метод вызывает событие изменения свойства, используя строковое значение CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY в качестве имени свойства.

Параметры:
b - false, если кнопки управления не должны отображаться; в противном случае, true
С тех пор:
1.3
См. также:
getControlButtonsAreShown(), CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY

getDialogType

public int getDialogType()

Возвращает тип этого диалогового окна. По умолчанию это JFileChooser.OPEN_DIALOG.

Возвращает:
тип диалога, который будет отображён:
  • JFileChooser.OPEN_DIALOG
  • JFileChooser.SAVE_DIALOG
  • JFileChooser.CUSTOM_DIALOG
См. также:
setDialogType(int)

setDialogType

@BeanProperty(preferred=true,
              enumerationValues={"JFileChooser.OPEN_DIALOG","JFileChooser.SAVE_DIALOG","JFileChooser.CUSTOM_DIALOG"},
              description="The type (open, save, custom) of the JFileChooser.")
public void setDialogType(int dialogType)

Устанавливает тип этого диалога. Используйте OPEN_DIALOG когда необходимо открыть диалог выбора файла, который пользователь может использовать для открытия файла. Аналогично, используйте SAVE_DIALOG для того, чтобы пользователь мог выбрать файл для сохранения. Используйте CUSTOM_DIALOG когда необходимо использовать диалог выбора файла в контексте, отличном от "Открыть" или "Сохранить". Например, вы можете открыть диалог выбора файла, который позволит пользователю выбрать файл для выполнения. Обратите внимание, что обычно вам не нужно устанавливать JFileChooser для использования CUSTOM_DIALOG, так как вызов setApproveButtonText делает это за вас. По умолчанию тип диалога равен JFileChooser.OPEN_DIALOG.

Параметры:
dialogType - тип диалога, который будет отображён:
  • JFileChooser.OPEN_DIALOG
  • JFileChooser.SAVE_DIALOG
  • JFileChooser.CUSTOM_DIALOG
Исключения:
IllegalArgumentException - если dialogType некорректен
См. также:
getDialogType(), setApproveButtonText(java.lang.String)

setDialogTitle

@BeanProperty(preferred=true,
              description="The title of the JFileChooser dialog window.")
public void setDialogTitle(String dialogTitle)

Устанавливает строку, которая отображается в JFileChooser заголовке окна.

Параметры:
dialogTitle - новое String для заголовка
См. также:
getDialogTitle()

getDialogTitle

public String getDialogTitle()

Возвращает строку, которая отображается в JFileChooser заголовке окна.

Возвращает:
строка из JFileChooser заголовка окна
См. также:
setDialogTitle(java.lang.String)

setApproveButtonToolTipText

@BeanProperty(preferred=true,
              description="The tooltip text for the ApproveButton.")
public void setApproveButtonToolTipText(String toolTipText)

Устанавливает подсказку для кнопки "ОК". Если null, объект пользовательского интерфейса определит текст кнопки.

Параметры:
toolTipText - текст подсказки для кнопки "ОК"
См. также:
setApproveButtonText(java.lang.String), setDialogType(int), showDialog(java.awt.Component, java.lang.String)

getApproveButtonToolTipText

public String getApproveButtonToolTipText()

Возвращает текст подсказки для кнопки "ОК". Если null, объект пользовательского интерфейса определит текст кнопки.

Возвращает:
текст подсказки для кнопки "ОК"
См. также:
setApproveButtonText(java.lang.String), setDialogType(int), showDialog(java.awt.Component, java.lang.String)

getApproveButtonMnemonic

public int getApproveButtonMnemonic()

Возвращает мнемонический символ для кнопки "ОК".

Возвращает:
целочисленное значение мнемонического символа
См. также:
setApproveButtonMnemonic(int)

setApproveButtonMnemonic

@BeanProperty(preferred=true,
              description="The mnemonic key accelerator for the ApproveButton.")
public void setApproveButtonMnemonic(int mnemonic)

Устанавливает мнемонический символ для кнопки "ОК" с использованием числового кода символа.

Параметры:
mnemonic - целочисленное значение мнемонического символа
См. также:
getApproveButtonMnemonic()

setApproveButtonMnemonic

public void setApproveButtonMnemonic(char mnemonic)

Устанавливает мнемонический символ для кнопки "ОК" с использованием символа.

Параметры:
mnemonic - символьное значение мнемонического символа
См. также:
getApproveButtonMnemonic()

setApproveButtonText

@BeanProperty(preferred=true,
              description="The text that goes in the ApproveButton.")
public void setApproveButtonText(String approveButtonText)

Устанавливает текст, используемый в кнопке "ОК" в FileChooserUI.

Параметры:
approveButtonText - текст, используемый в кнопке "ОК"
См. также:
getApproveButtonText(), setDialogType(int), showDialog(java.awt.Component, java.lang.String)

getApproveButtonText

public String getApproveButtonText()

Возвращает текст, используемый в кнопке "ОК" в FileChooserUI. Если null, объект пользовательского интерфейса определит текст кнопки. Обычно это "Открыть" или "Сохранить".

Возвращает:
текст, используемый в кнопке "ОК"
См. также:
setApproveButtonText(java.lang.String), setDialogType(int), showDialog(java.awt.Component, java.lang.String)

getChoosableFileFilters

@BeanProperty(bound=false)
public FileFilter[] getChoosableFileFilters()

Возвращает список доступных фильтров файлов.

Возвращает:
массив FileFilter содержащий все доступные фильтры файлов
См. также:
addChoosableFileFilter(javax.swing.filechooser.FileFilter), removeChoosableFileFilter(javax.swing.filechooser.FileFilter), resetChoosableFileFilters()

addChoosableFileFilter

@BeanProperty(preferred=true,
              description="Adds a filter to the list of user choosable file filters.")
public void addChoosableFileFilter(FileFilter filter)

Добавляет фильтр в список доступных фильтров файлов. Для информации по установке режима выбора файла, см. setFileSelectionMode.

Параметры:
filter - FileFilter для добавления в список доступных фильтров
См. также:
getChoosableFileFilters(), removeChoosableFileFilter(javax.swing.filechooser.FileFilter), resetChoosableFileFilters(), setFileSelectionMode(int)

removeChoosableFileFilter

public boolean removeChoosableFileFilter(FileFilter f)

Удаляет фильтр из списка доступных фильтров файлов. Возвращает true, если фильтр был удалён.

Параметры:
f - фильтр файла для удаления
Возвращает:
true, если фильтр был удалён, иначе false
См. также:
addChoosableFileFilter(javax.swing.filechooser.FileFilter), getChoosableFileFilters(), resetChoosableFileFilters()

resetChoosableFileFilters

public void resetChoosableFileFilters()

Возвращает список доступных фильтров файлов в исходное состояние. Обычно это удаляет все добавленные фильтры, оставляя AcceptAll фильтр файлов.

См. также:
addChoosableFileFilter(javax.swing.filechooser.FileFilter), getChoosableFileFilters(), removeChoosableFileFilter(javax.swing.filechooser.FileFilter)

getAcceptAllFileFilter

@BeanProperty(bound=false)
public FileFilter getAcceptAllFileFilter()

Возвращает фильтр "Все файлы". Например, в Microsoft Windows это будет "Все файлы (*.*)".

Возвращает:
фильтр "Все файлы"

isAcceptAllFileFilterUsed

public boolean isAcceptAllFileFilterUsed()

Возвращает, используется ли фильтр "Все файлы".

Возвращает:
true, если используется фильтр "Все файлы"
С тех пор:
1.3
См. также:
setAcceptAllFileFilterUsed(boolean)

setAcceptAllFileFilterUsed

@BeanProperty(preferred=true,
              description="Sets whether the AcceptAll FileFilter is used as an available choice in the choosable filter list.")
public void setAcceptAllFileFilterUsed(boolean b)

Определяет, используется ли фильтр "Все файлы" в качестве доступного выбора в списке фильтров. Если false, фильтр "Все файлы" удаляется из списка доступных фильтров файлов. Если true, фильтр "Все файлы" станет активным фильтром.

Параметры:
b - значение, определяющее, используется ли фильтр "Все файлы" как доступный выбор в списке фильтров
С тех пор:
1.3
См. также:
isAcceptAllFileFilterUsed(), getAcceptAllFileFilter(), setFileFilter(javax.swing.filechooser.FileFilter)

getAccessory

public JComponent getAccessory()

Возвращает дополнительный компонент.

Возвращает:
дополнительный компонент JFileChooser, или null
См. также:
setAccessory(javax.swing.JComponent)

setAccessory

@BeanProperty(preferred=true,
              description="Sets the accessory component on the JFileChooser.")
public void setAccessory(JComponent newAccessory)

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

Примечание: если был предыдущий дополнительный компонент, вы должны отменить регистрацию любых слушателей, которые мог зарегистрировать дополнительный компонент с диалогом выбора файлов.

Параметры:
newAccessory - устанавливаемый дополнительный компонент

setFileSelectionMode

@BeanProperty(preferred=true,
              enumerationValues={"JFileChooser.FILES_ONLY","JFileChooser.DIRECTORIES_ONLY","JFileChooser.FILES_AND_DIRECTORIES"},
              description="Sets the types of files that the JFileChooser can choose.")
public void setFileSelectionMode(int mode)

Устанавливает JFileChooser для выбора только файлов, только каталогов или и файлов, и каталогов. По умолчанию - JFilesChooser.FILES_ONLY.

Параметры:
mode - тип отображаемых файлов:
  • JFileChooser.FILES_ONLY
  • JFileChooser.DIRECTORIES_ONLY
  • JFileChooser.FILES_AND_DIRECTORIES
Исключения:
IllegalArgumentException - если mode является недопустимым режимом выбора файлов
См. также:
getFileSelectionMode()

getFileSelectionMode

public int getFileSelectionMode()

Возвращает текущий режим выбора файлов. По умолчанию - JFilesChooser.FILES_ONLY.

Возвращает:
тип файлов для отображения, один из следующих:
  • JFileChooser.FILES_ONLY
  • JFileChooser.DIRECTORIES_ONLY
  • JFileChooser.FILES_AND_DIRECTORIES
См. также:
setFileSelectionMode(int)

isFileSelectionEnabled

@BeanProperty(bound=false)
public boolean isFileSelectionEnabled()

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

Возвращает:
true, если файлы можно выбрать, иначе false
См. также:
setFileSelectionMode(int), getFileSelectionMode()

isDirectorySelectionEnabled

@BeanProperty(bound=false)
public boolean isDirectorySelectionEnabled()

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

Возвращает:
true, если каталоги можно выбрать, иначе false
См. также:
setFileSelectionMode(int), getFileSelectionMode()

setMultiSelectionEnabled

@BeanProperty(description="Sets multiple file selection mode.")
public void setMultiSelectionEnabled(boolean b)

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

Параметры:
b - true, если можно выбрать несколько файлов
См. также:
isMultiSelectionEnabled()

isMultiSelectionEnabled

public boolean isMultiSelectionEnabled()

Возвращает true, если можно выбрать несколько файлов.

Возвращает:
true, если можно выбрать несколько файлов
См. также:
setMultiSelectionEnabled(boolean)

isFileHidingEnabled

public boolean isFileHidingEnabled()

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

Возвращает:
состояние свойства скрытия файлов
См. также:
setFileHidingEnabled(boolean)

setFileHidingEnabled

@BeanProperty(preferred=true,
              description="Sets file hiding on or off.")
public void setFileHidingEnabled(boolean b)

Включает или выключает скрытие файлов. Если true, скрытые файлы не отображаются в файловом диалоге. Задача определения, какие файлы отображать, выполняется FileView.

Параметры:
b - значение boolean, определяющее включение скрытия файлов
См. также:
isFileHidingEnabled()

setFileFilter

@BeanProperty(preferred=true,
              description="Sets the File Filter used to filter out files of type.")
public void setFileFilter(FileFilter filter)

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

Параметры:
filter - новый текущий фильтр файлов
См. также:
getFileFilter()

getFileFilter

public FileFilter getFileFilter()

Возвращает текущий выбранный фильтр файлов.

Возвращает:
текущий фильтр файлов
См. также:
setFileFilter(javax.swing.filechooser.FileFilter), addChoosableFileFilter(javax.swing.filechooser.FileFilter)

setFileView

@BeanProperty(preferred=true,
              description="Sets the File View used to get file type information.")
public void setFileView(FileView fileView)

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

Параметры:
fileView - представление для получения информации пользовательского интерфейса
См. также:
getFileView()

getFileView

public FileView getFileView()

Возвращает текущее представление файлов.

Возвращает:
текущее представление файлов
См. также:
setFileView(javax.swing.filechooser.FileView)

getName

public String getName(File f)

Возвращает имя файла.

Параметры:
f - файл
Возвращает:
строку, содержащую имя файла для f
См. также:
FileView.getName(java.io.File)

getDescription

public String getDescription(File f)

Возвращает описание файла.

Параметры:
f - файл
Возвращает:
строку, содержащую описание файла для f
См. также:
FileView.getDescription(java.io.File)

getTypeDescription

public String getTypeDescription(File f)

Возвращает тип файла.

Параметры:
f - файл
Возвращает:
строку, содержащую описание типа файла для f
См. также:
FileView.getTypeDescription(java.io.File)

getIcon

public Icon getIcon(File f)

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

Параметры:
f - файл
Возвращает:
значок для данного файла или типа файла
См. также:
FileView.getIcon(java.io.File)

isTraversable

public boolean isTraversable(File f)

Возвращает true, если файл (каталог) можно посетить. Возвращает false, если каталог недоступен для просмотра.

Параметры:
f - файл
Возвращает:
true, если файл/каталог доступен для просмотра, иначе false
См. также:
FileView.isTraversable(java.io.File)

accept

public boolean accept(File f)

Возвращает true, если файл должен быть отображен.

Параметры:
f - файл
Возвращает:
true, если файл должен быть отображен, иначе false
См. также:
FileFilter.accept(java.io.File)

setFileSystemView

@BeanProperty(expert=true,
              description="Sets the FileSytemView used to get filesystem information.")
public void setFileSystemView(FileSystemView fsv)

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

Параметры:
fsv - новое представление файловой системы
См. также:
FileSystemView

getFileSystemView

public FileSystemView getFileSystemView()

Возвращает представление файловой системы.

Возвращает:
объект представления файловой системы
См. также:
setFileSystemView(javax.swing.filechooser.FileSystemView)

approveSelection

public void approveSelection()

Вызывается пользовательским интерфейсом при нажатии пользователем кнопки "Принять" (по умолчанию "Открыть" или "Сохранить"). Это также может вызываться программистом. Этот метод вызывает событие действия со строкой команды, равной APPROVE_SELECTION.

См. также:
APPROVE_SELECTION

cancelSelection

public void cancelSelection()

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

См. также:
CANCEL_SELECTION

addActionListener

public void addActionListener(ActionListener l)

Добавляет слушателя событий к файловому диалогу.

Параметры:
l - добавляемый слушатель
См. также:
approveSelection(), cancelSelection()

removeActionListener

public void removeActionListener(ActionListener l)

Удаляет слушателя событий из файлового диалога.

Параметры:
l - удаляемый слушатель
См. также:
addActionListener(java.awt.event.ActionListener)

getActionListeners

@BeanProperty(bound=false)
public ActionListener[] getActionListeners()

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

Возвращает:
все слушатели событий действия данного файлового диалога или пустой массив, если слушатели не зарегистрированы
С:
1.4
См. также:
addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener)

fireActionPerformed

protected void fireActionPerformed(String command)

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

Параметры:
command - строка, которая может указывать команду, связанную с событием
См. также:
EventListenerList

updateUI

public void updateUI()

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

Переопределяет:
updateUI в классе JComponent
См. также:
JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false,
              expert=true,
              description="A string that specifies the name of the L&F class.")
public String getUIClassID()

Возвращает строку, которая указывает имя класса L&F, отображающего этот компонент.

Переопределяет:
getUIClassID в классе JComponent
Возвращает:
"FileChooserUI"
См. также:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

getUI

@BeanProperty(bound=false)
public FileChooserUI getUI()

Получает объект UI, реализующий L&F для этого компонента.

Переопределяет:
getUI в классе JComponent
Возвращает:
объект FileChooserUI, реализующий L&F FileChooserUI

paramString

protected String paramString()

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

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

getAccessibleContext

@BeanProperty(bound=false)
public AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этим JFileChooser. Для выбора файлов AccessibleContext принимает форму AccessibleJFileChooser. Новый экземпляр AccessibleJFileChooser создаётся при необходимости.

Определено в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Component
Возвращает:
AccessibleJFileChooser, который служит AccessibleContext для этого JFileChooser

© 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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/javax/swing/JFileChooser.html

Spec-Zone .ru
спецификации, руководства, описания, API