Класс JFileChooser

public static final int OPEN_DIALOG

См. также:

• Значения константного поля

public static final int SAVE_DIALOG

См. также:

• Значения константного поля

public static final int CUSTOM_DIALOG

См. также:

• Значения константного поля

public static final int CANCEL_OPTION

См. также:

• Значения константного поля

public static final int APPROVE_OPTION

См. также:

• Значения константного поля

public static final int ERROR_OPTION

См. также:

• Значения константного поля

public static final int FILES_ONLY

См. также:

• Значения константного поля

public static final int DIRECTORIES_ONLY

См. также:

• Значения константного поля

public static final int FILES_AND_DIRECTORIES

См. также:

• Значения константного поля

public static final String CANCEL_SELECTION

См. также:

• Значения константного поля

public static final String APPROVE_SELECTION

См. также:

• Значения константного поля

public static final String APPROVE_BUTTON_TEXT_CHANGED_PROPERTY

См. также:

• Значения константного поля

public static final String APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY

См. также:

• Значения константного поля

public static final String APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY

См. также:

• Значения константного поля

public static final String CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY

См. также:

• Значения константного поля

public static final String DIRECTORY_CHANGED_PROPERTY

См. также:

• Значения константного поля

public static final String SELECTED_FILE_CHANGED_PROPERTY

См. также:

• Значения константного поля

public static final String SELECTED_FILES_CHANGED_PROPERTY

См. также:

• Значения константного поля

public static final String MULTI_SELECTION_ENABLED_CHANGED_PROPERTY

См. также:

• Значения константного поля

public static final String FILE_SYSTEM_VIEW_CHANGED_PROPERTY

См. также:

• Значения константного поля

public static final String FILE_VIEW_CHANGED_PROPERTY

См. также:

• Значения константного поля

public static final String FILE_HIDING_CHANGED_PROPERTY

См. также:

• Значения константного поля

public static final String FILE_FILTER_CHANGED_PROPERTY

См. также:

• Значения константного поля

public static final String FILE_SELECTION_MODE_CHANGED_PROPERTY

См. также:

• Значения константных полей

public static final String ACCESSORY_CHANGED_PROPERTY

См. также:

• Значения константных полей

public static final String ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY

См. также:

• Значения константных полей

public static final String DIALOG_TITLE_CHANGED_PROPERTY

См. также:

• Значения константных полей

public static final String DIALOG_TYPE_CHANGED_PROPERTY

См. также:

• Значения константных полей

public static final String CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY

См. также:

• Значения константных полей

protected AccessibleContext accessibleContext

public JFileChooser()

public JFileChooser(String currentDirectoryPath)

Параметры:

currentDirectoryPath - строка, определяющая путь к файлу или каталогу

public JFileChooser(File currentDirectory)

Параметры:

currentDirectory - объект File, определяющий путь к файлу или каталогу

public JFileChooser(FileSystemView fsv)

Параметры:

fsv - FileSystemView

public JFileChooser(File currentDirectory, FileSystemView fsv)

Параметры:

currentDirectory - объект File, определяющий путь к файлу или каталогу

fsv - FileSystemView

public JFileChooser(String currentDirectoryPath, FileSystemView fsv)

Параметры:

currentDirectoryPath - строка, определяющая путь к файлу или каталогу

fsv - FileSystemView

protected void setup(FileSystemView view)

Параметры:

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

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

Параметры:

b - значение, которому следует установить свойство dragEnabled

Исключения:

HeadlessException - если b равно true, и GraphicsEnvironment.isHeadless() возвращает true

С момента:

1.4

См. также:

• GraphicsEnvironment.isHeadless()
• getDragEnabled()
• JComponent.setTransferHandler(javax.swing.TransferHandler)
• TransferHandler

public boolean getDragEnabled()

Возвращает:

значение свойства dragEnabled

С момента:

1.4

См. также:

• setDragEnabled(boolean)

public File getSelectedFile()

Возвращает:

выбранный файл

См. также:

• setSelectedFile(java.io.File)

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

Параметры:

file - выбранный файл

См. также:

• getSelectedFile()

public File[] getSelectedFiles()

Возвращает:

массив выбранных файлов

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

Параметры:

selectedFiles - массив файлов, которые нужно выбрать

public File getCurrentDirectory()

Возвращает:

текущую директорию

См. также:

• setCurrentDirectory(java.io.File)

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

Параметры:

dir - текущая директория, на которую нужно перейти

См. также:

• getCurrentDirectory()

public void changeToParentDirectory()

См. также:

• getCurrentDirectory()

public void rescanCurrentDirectory()

public void ensureFileIsVisible(File f)

Параметры:

f - объект File

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)

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)

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 - родительский компонент диалогового окна; может быть null

approveButtonText - текст кнопки ApproveButton

Возвращает:

результат работы файлового выбора при закрытии окна:

• JFileChooser.CANCEL_OPTION
• JFileChooser.APPROVE_OPTION
• JFileChooser.ERROR_OPTION, если произошла ошибка или диалоговое окно было закрыто

Исключения:

HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

• GraphicsEnvironment.isHeadless()

protected JDialog createDialog(Component parent) throws HeadlessException

     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()

public boolean getControlButtonsAreShown()

Возвращает:

значение свойства controlButtonsAreShown

С:

1.3

См. также:

• setControlButtonsAreShown(boolean)

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

Параметры:

b - false, если кнопки не должны отображаться; в противном случае, true

С:

1.3

См. также:

• getControlButtonsAreShown()
• CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY

public int getDialogType()

Возвращает:

тип отображаемого диалогового окна:

• JFileChooser.OPEN_DIALOG
• JFileChooser.SAVE_DIALOG
• JFileChooser.CUSTOM_DIALOG

См. также:

• setDialogType(int)

@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)

Параметры:

dialogType - тип отображаемого диалогового окна:

• JFileChooser.OPEN_DIALOG
• JFileChooser.SAVE_DIALOG
• JFileChooser.CUSTOM_DIALOG

Исключения:

IllegalArgumentException - если dialogType не является допустимым

См. также:

• getDialogType()
• setApproveButtonText(java.lang.String)

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

Параметры:

dialogTitle - новое значение String для строки заголовка

См. также:

• getDialogTitle()

public String getDialogTitle()

Возвращает:

строку из строки заголовка окна JFileChooser

См. также:

• setDialogTitle(java.lang.String)

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

Параметры:

toolTipText - текст всплывающей подсказки для кнопки подтверждения

См. также:

• setApproveButtonText(java.lang.String)
• setDialogType(int)
• showDialog(java.awt.Component, java.lang.String)

public String getApproveButtonToolTipText()

Возвращает:

текст всплывающей подсказки для кнопки подтверждения

См. также:

• setApproveButtonText(java.lang.String)
• setDialogType(int)
• showDialog(java.awt.Component, java.lang.String)

public int getApproveButtonMnemonic()

Возвращает:

целочисленное значение для мнемонической клавиши

См. также:

• setApproveButtonMnemonic(int)

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

Параметры:

mnemonic - целочисленное значение для мнемонической клавиши

См. также:

• getApproveButtonMnemonic()

public void setApproveButtonMnemonic(char mnemonic)

Параметры:

mnemonic - символьное значение для мнемонической клавиши

См. также:

• getApproveButtonMnemonic()

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

Параметры:

approveButtonText - текст, используемый в ApproveButton

См. также:

• getApproveButtonText()
• setDialogType(int)
• showDialog(java.awt.Component, java.lang.String)

public String getApproveButtonText()

Возвращает:

текст, используемый в ApproveButton

См. также:

• setApproveButtonText(java.lang.String)
• setDialogType(int)
• showDialog(java.awt.Component, java.lang.String)

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

Возвращает:

массив FileFilter, содержащий все фильтры файлов, которые можно выбрать

См. также:

• addChoosableFileFilter(javax.swing.filechooser.FileFilter)
• removeChoosableFileFilter(javax.swing.filechooser.FileFilter)
• resetChoosableFileFilters()

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

Параметры:

filter - FileFilter для добавления в список фильтров файлов, которые можно выбрать

См. также:

• getChoosableFileFilters()
• removeChoosableFileFilter(javax.swing.filechooser.FileFilter)
• resetChoosableFileFilters()
• setFileSelectionMode(int)

public boolean removeChoosableFileFilter(FileFilter f)

Параметры:

f - фильтр файла, который нужно удалить

Возвращает:

true, если фильтр файла был удален, иначе false

См. также:

• addChoosableFileFilter(javax.swing.filechooser.FileFilter)
• getChoosableFileFilters()
• resetChoosableFileFilters()

public void resetChoosableFileFilters()

См. также:

• addChoosableFileFilter(javax.swing.filechooser.FileFilter)
• getChoosableFileFilters()
• removeChoosableFileFilter(javax.swing.filechooser.FileFilter)

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

Возвращает:

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

public boolean isAcceptAllFileFilterUsed()

Возвращает:

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

Since:

1.3

См. также:

• setAcceptAllFileFilterUsed(boolean)

@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)

Параметры:

b - значение, определяющее, является ли фильтр файла "Все файлы" доступным выбором в списке доступных фильтров

Since:

1.3

См. также:

• isAcceptAllFileFilterUsed()
• getAcceptAllFileFilter()
• setFileFilter(javax.swing.filechooser.FileFilter)

public JComponent getAccessory()

Возвращает:

дополнительный компонент JFileChooser, или null

См. также:

• setAccessory(javax.swing.JComponent)

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

Параметры:

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

@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)

Параметры:

mode - тип отображаемых файлов:

• JFileChooser.FILES_ONLY
• JFileChooser.DIRECTORIES_ONLY
• JFileChooser.FILES_AND_DIRECTORIES

Исключения:

IllegalArgumentException - если mode является недопустимым режимом выбора файлов

См. также:

• getFileSelectionMode()

public int getFileSelectionMode()

Возвращает:

тип отображаемых файлов:

• JFileChooser.FILES_ONLY
• JFileChooser.DIRECTORIES_ONLY
• JFileChooser.FILES_AND_DIRECTORIES

См. также:

• setFileSelectionMode(int)

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

Возвращает:

true, если файлы выбираемы, иначе false

См. также:

• setFileSelectionMode(int)
• getFileSelectionMode()

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

Возвращает:

true, если каталоги выбираемы, иначе false

См. также:

• setFileSelectionMode(int)
• getFileSelectionMode()

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

Параметры:

b - true, если разрешено выбрать несколько файлов

См. также:

• isMultiSelectionEnabled()

public boolean isMultiSelectionEnabled()

Возвращает:

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

См. также:

• setMultiSelectionEnabled(boolean)

public boolean isFileHidingEnabled()

Возвращает:

статус свойства скрытия файлов

См. также:

• setFileHidingEnabled(boolean)

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

Параметры:

b - логическое значение, определяющее включение скрытия файлов

См. также:

• isFileHidingEnabled()

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

Параметры:

filter - новый текущий фильтр файлов

См. также:

• getFileFilter()

public FileFilter getFileFilter()

Возвращает:

текущий фильтр файлов

См. также:

• setFileFilter(javax.swing.filechooser.FileFilter)
• addChoosableFileFilter(javax.swing.filechooser.FileFilter)

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

Параметры:

fileView - FileView для получения UI информации

См. также:

• getFileView()

public FileView getFileView()

Возвращает:

текущий вид файла

См. также:

• setFileView(javax.swing.filechooser.FileView)

public String getName(File f)

Параметры:

f - File

Возвращает:

String, содержащее имя файла для f

См. также:

• FileView.getName(java.io.File)

public String getDescription(File f)

Параметры:

f - File

Возвращает:

String, содержащее описание файла для f

См. также:

• FileView.getDescription(java.io.File)

public String getTypeDescription(File f)

Параметры:

f - File

Возвращает:

String, содержащее описание типа файла для f

См. также:

• FileView.getTypeDescription(java.io.File)

public Icon getIcon(File f)

Параметры:

f - File

Возвращает:

значок для этого файла или типа файла

См. также:

• FileView.getIcon(java.io.File)

public boolean isTraversable(File f)

Параметры:

f - File

Возвращает:

true, если файл/каталог может быть пройден, иначе false

См. также:

• FileView.isTraversable(java.io.File)

public boolean accept(File f)

Параметры:

f - File

Возвращает:

true, если файл должен быть отображён, иначе false

См. также:

• FileFilter.accept(java.io.File)

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

Параметры:

fsv - новый FileSystemView

См. также:

• FileSystemView

public FileSystemView getFileSystemView()

Возвращает:

объект FileSystemView

См. также:

• setFileSystemView(javax.swing.filechooser.FileSystemView)

public void approveSelection()

См. также:

• APPROVE_SELECTION

public void cancelSelection()

См. также:

• CANCEL_SELECTION

public void addActionListener(ActionListener l)

Параметры:

l - слушатель для добавления

См. также:

• approveSelection()
• cancelSelection()

public void removeActionListener(ActionListener l)

Параметры:

l - слушатель для удаления

См. также:

• addActionListener(java.awt.event.ActionListener)

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

Возвращает:

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

С момента:

1.4

См. также:

• addActionListener(java.awt.event.ActionListener)
• removeActionListener(java.awt.event.ActionListener)

protected void fireActionPerformed(String command)

Параметры:

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

См. также:

• EventListenerList

public void updateUI()

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

updateUI в классе JComponent

См. также:

• JComponent.updateUI()

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

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

getUIClassID в классе JComponent

Возвращает:

строку "FileChooserUI"

См. также:

• JComponent.getUIClassID()
• UIDefaults.getUI(javax.swing.JComponent)

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

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

getUI в классе JComponent

Возвращает:

объект FileChooserUI, реализующий L&F FileChooserUI

protected String paramString()

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

paramString в классе JComponent

Возвращает:

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

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

Определено в:

getAccessibleContext в интерфейсе Accessible

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

getAccessibleContext в классе Component

Возвращает:

AccessibleJFileChooser, используемый в качестве AccessibleContext этого JFileChooser

public void setEnabled(boolean enabled)

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

setEnabled в классе JComponent

Параметры:

enabled — true, если этот компонент должен быть активным, false в противном случае

См. также:

• Component.isEnabled()
• Component.isLightweight()