Класс 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 — String, задающая путь к файлу или каталогу

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 — String, задающая путь к файлу или каталогу

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

public boolean getDragEnabled()

Возвращает:

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

С:

1.4

См. также:

• setDragEnabled(boolean)

public File getSelectedFile()

Возвращает:

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

См. также:

• setSelectedFile(File)

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

Параметры:

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

См. также:

• getSelectedFile()

public File[] getSelectedFiles()

Возвращает:

массив выбранных объектов File

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

Параметры:

selectedFiles — массив объектов File для выбора

public File getCurrentDirectory()

Возвращает:

текущий каталог

См. также:

• setCurrentDirectory(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(Component, 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(Component, 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

См. также:

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

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

Параметры:

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

См. также:

• setApproveButtonText(String)
• setDialogType(int)
• showDialog(Component, String)

public String getApproveButtonToolTipText()

Возвращает:

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

См. также:

• setApproveButtonText(String)
• setDialogType(int)
• showDialog(Component, 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(Component, String)

public String getApproveButtonText()

Возвращает:

текст для ApproveButton

См. также:

• setApproveButtonText(String)
• setDialogType(int)
• showDialog(Component, String)

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

Возвращает:

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

См. также:

• addChoosableFileFilter(FileFilter)
• removeChoosableFileFilter(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(FileFilter)
• resetChoosableFileFilters()
• setFileSelectionMode(int)

public boolean removeChoosableFileFilter(FileFilter f)

Параметры:

f — удаляемый фильтр файлов

Возвращает:

true, если фильтр файлов был удален; в противном случае — false

См. также:

• addChoosableFileFilter(FileFilter)
• getChoosableFileFilters()
• resetChoosableFileFilters()

public void resetChoosableFileFilters()

См. также:

• addChoosableFileFilter(FileFilter)
• getChoosableFileFilters()
• removeChoosableFileFilter(FileFilter)

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

Возвращает:

фильтр файлов AcceptAll

public boolean isAcceptAllFileFilterUsed()

Возвращает:

true, если используется AcceptAll FileFilter

Начиная с:

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 — boolean, определяющее, доступен ли фильтр файлов AcceptAll в списке фильтров

Начиная с:

1.3

См. также:

• isAcceptAllFileFilterUsed()
• getAcceptAllFileFilter()
• setFileFilter(FileFilter)

public JComponent getAccessory()

Возвращает:

вспомогательный компонент этого JFileChooser или null

См. также:

• setAccessory(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(FileFilter)
• addChoosableFileFilter(FileFilter)

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

Параметры:

fileView — FileView, используемое для получения сведений пользовательского интерфейса

См. также:

• getFileView()

public FileView getFileView()

Возвращает:

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

См. также:

• setFileView(FileView)

public String getName(File f)

Параметры:

f — File

Возвращает:

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

См. также:

• FileView.getName(File)

public String getDescription(File f)

Параметры:

f — File

Возвращает:

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

См. также:

• FileView.getDescription(File)

public String getTypeDescription(File f)

Параметры:

f — File

Возвращает:

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

См. также:

• FileView.getTypeDescription(File)

public Icon getIcon(File f)

Параметры:

f — File

Возвращает:

Icon для этого файла или типа файла

См. также:

• FileView.getIcon(File)

public boolean isTraversable(File f)

Параметры:

f — File

Возвращает:

true, если файл или каталог можно просматривать; в противном случае — false

См. также:

• FileView.isTraversable(File)

public boolean accept(File f)

Параметры:

f — File

Возвращает:

true, если файл следует отображать; в противном случае — false

См. также:

• FileFilter.accept(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(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(ActionListener)

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

Возвращает:

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

Начиная с:

1.4

См. также:

• addActionListener(ActionListener)
• removeActionListener(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(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()