Spec-Zone.ru › OpenJDK 21

Класс JFileChooser

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.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.

Следующий код отображает диалог выбора файлов для домашнего каталога пользователя, показывая только изображения форматов .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 final String ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY
Указывает, используется ли AcceptAllFileFilter или нет.
protected AccessibleContext accessibleContext
AccessibleContext связан с этим JFileChooser
static final String ACCESSORY_CHANGED_PROPERTY
Указывает, что используется другой компонент аксессуара (например, для предварительного просмотра файлов).
static final String APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY
Указывает изменение мнемоники для кнопки подтверждения (да, ок).
static final String APPROVE_BUTTON_TEXT_CHANGED_PROPERTY
Указывает изменение текста на кнопке подтверждения (да, ок).
static final String APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY
Указывает изменение текста всплывающей подсказки для кнопки подтверждения (да, ок).
static final int APPROVE_OPTION
Значение возврата, если выбрано подтверждение (да, ок).
static final String APPROVE_SELECTION
Инструкция для подтверждения текущего выбора (то же, что нажатие на «да» или «ок»).
static final int CANCEL_OPTION
Значение возврата, если выбран отмена.
static final String CANCEL_SELECTION
Инструкция для отмены текущего выбора.
static final String CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY
Указывает изменение списка предопределенных фильтров файлов, из которых может выбрать пользователь.
static final String CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
Инструкция для отображения кнопок управления.
static final int CUSTOM_DIALOG
Значение типа, указывающее, что JFileChooser поддерживает операцию с файлом, заданную разработчиком.
static final String DIALOG_TITLE_CHANGED_PROPERTY
Указывает изменение заголовка диалогового окна.
static final String DIALOG_TYPE_CHANGED_PROPERTY
Идентифицирует изменение типа отображаемых файлов (только файлы, только каталоги или и то, и другое).
static final int DIRECTORIES_ONLY
Инструкция отобразить только каталоги.
static final String DIRECTORY_CHANGED_PROPERTY
Идентифицирует изменение каталога пользователя.
static final int ERROR_OPTION
Возвращаемое значение, если произошла ошибка.
static final String FILE_FILTER_CHANGED_PROPERTY
Пользователь изменил тип отображаемых файлов.
static final String FILE_HIDING_CHANGED_PROPERTY
Идентифицирует изменение свойства отображения скрытых файлов.
static final String FILE_SELECTION_MODE_CHANGED_PROPERTY
Идентифицирует изменение типа выбора (один, несколько и т. д.).
static final String FILE_SYSTEM_VIEW_CHANGED_PROPERTY
Указывает, что используется другой объект для поиска доступных дисков в системе.
static final String FILE_VIEW_CHANGED_PROPERTY
Указывает, что используется другой объект для получения информации о файлах.
static final int FILES_AND_DIRECTORIES
Инструкция отобразить и файлы, и каталоги.
static final int FILES_ONLY
Инструкция отобразить только файлы.
static final String MULTI_SELECTION_ENABLED_CHANGED_PROPERTY
Включает возможность выбора нескольких файлов.
static final int OPEN_DIALOG
Значение типа, указывающее, что JFileChooser поддерживает операцию "Открыть" файла.
static final int SAVE_DIALOG
Значение типа, указывающее, что JFileChooser поддерживает операцию "Сохранить" файла.
static final String SELECTED_FILE_CHANGED_PROPERTY
Идентифицирует изменение выбора одного файла пользователем.
static final 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()
Возвращает объект UI, реализующий 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()
Сообщает UI о необходимости повторного сканирования списка файлов из текущей директории.
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)
Устанавливает список выбранных файлов, если в файловом обозревателе разрешен множественный выбор.
protected void setup(FileSystemView view)
Выполняет общие действия инициализации и настройки конструктора.
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, hide, 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, 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
Возвращаемое значение, если произошла ошибка.
См. также:
  • Значения константных полей

ТОЛЬКО_Файлы

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
Идентифицирует изменение выбора пользователем нескольких файлов.
См. также:
  • Значения константных полей

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

JFileChooser

public JFileChooser(File currentDirectory)
Создаёт JFileChooser, используя заданный File в качестве пути. Передача файла null приводит к тому, что файловый выборщик указывает на стандартный каталог пользователя. Этот стандартный каталог зависит от операционной системы. Обычно это папка "Документы" в Windows и домашний каталог пользователя в Unix.
Parameters:
currentDirectory - объект File, задающий путь к файлу или каталогу

JFileChooser

public JFileChooser(FileSystemView fsv)
Создаёт JFileChooser, используя заданный FileSystemView.
Parameters:
fsv - FileSystemView

JFileChooser

public JFileChooser(File currentDirectory, FileSystemView fsv)
Создаёт JFileChooser, используя заданный текущий каталог и FileSystemView.
Parameters:
currentDirectory - объект File, задающий путь к файлу или каталогу
fsv - FileSystemView

JFileChooser

public JFileChooser(String currentDirectoryPath, FileSystemView fsv)
Создаёт JFileChooser используя указанный путь к текущей директории и FileSystemView.
Parameters:
currentDirectoryPath - строка, определяющая путь к файлу или каталогу
fsv - FileSystemView

Подробное описание методов

setup

protected void setup(FileSystemView view)
Выполняет общую инициализацию и настройку конструктора.
Parameters:
view - FileSystemView, используемый для настройки

setDragEnabled

@BeanProperty(bound=false, description="determines whether automatic drag handling is enabled") public void setDragEnabled(boolean b)
Устанавливает свойство dragEnabled, которое должно быть true для включения автоматической обработки перетаскивания (первая часть перетаскивания и перемещения) в этом компоненте. Свойство transferHandler должно быть установлено на значение, отличное от null, чтобы перетаскивание работало. Значение свойства dragEnabled по умолчанию равно false.

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

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

Parameters:
b - значение, устанавливаемое для свойства dragEnabled
Throws:
HeadlessException - если b равно true и GraphicsEnvironment.isHeadless() возвращает true
Since:
1.4
See Also:
  • 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)

Установить текущую директорию

@BeanProperty(preferred=true, description="The directory that the JFileChooser is showing files of.") public void setCurrentDirectory(File dir)
Устанавливает текущую директорию. Передача null устанавливает файловый выборник на стандартную директорию пользователя. Эта директория зависит от операционной системы. Как правило, это папка "Документы" в Windows и домашний каталог пользователя в Unix. Если переданный как currentDirectory файл не является директорией, родительская директория файла будет использована в качестве текущей директории. Если родительская директория недоступна, то будет происходить переход к родительским директориям, пока не будет найдена доступная директория или корневой каталог файловой системы.
Параметры:
dir - текущая директория, на которую нужно установить указатель
См. также:
  • getCurrentDirectory()

Перейти в родительскую директорию

public void changeToParentDirectory()
Изменяет директорию на родительскую по отношению к текущей.
См. также:
  • getCurrentDirectory()

Пересканировать текущую директорию

public void rescanCurrentDirectory()
Заставляет пользовательский интерфейс пересканировать список файлов в текущей директории.

Убедиться, что файл виден

public void ensureFileIsVisible(File f)
Убеждается, что указанный файл отображается, а не скрыт.
Параметры:
f - объект File

showOpenDialog

public int showOpenDialog(Component parent) throws HeadlessException
Выводит диалоговое окно "Открыть файл". Обратите внимание, что текст, отображаемый на кнопке "Принять", определяется L&F.
Параметры:
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
Выводит диалоговое окно выбора файла "Сохранить файл". Обратите внимание, что текст, отображаемый на кнопке подтверждения, определяется L&F.
Параметры:
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, то диалоговое окно не зависит от видимого окна и размещается в позиции, зависящей от интерфейса пользователя, например, в центре экрана.

Parameters:
parent - родительский компонент диалогового окна; может быть null
approveButtonText - текст ApproveButton
Returns:
состояние возврата окна выбора файла при закрытии:
  • JFileChooser.CANCEL_OPTION
  • JFileChooser.APPROVE_OPTION
  • JFileChooser.ERROR_OPTION, если произошла ошибка или диалоговое окно было закрыто
Throws:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
See Also:
  • GraphicsEnvironment.isHeadless()

создатьДиалог

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

ТипДиалога

public int getDialogType()
Возвращает тип этого диалога. По умолчанию это JFileChooser.OPEN_DIALOG.
Возвращает:
тип отображаемого диалога:
  • 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)
Устанавливает тип этого диалога. Используйте 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)

УстановитьЗаголовокДиалога

@BeanProperty(preferred=true, description="The title of the JFileChooser dialog window.") public void setDialogTitle(String dialogTitle)
Устанавливает строку, отображаемую в строке заголовка окна JFileChooser.
Параметры:
dialogTitle - новый String для строки заголовка
См. также:
  • getDialogTitle()

ПолучитьЗаголовокДиалога

public String getDialogTitle()
Возвращает строку, отображаемую в строке заголовка окна JFileChooser.
Возвращает:
строка из строки заголовка окна JFileChooser
См. также:
  • setDialogTitle(java.lang.String)

Установить подсказку для кнопки «Подтвердить»

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

Получить подсказку для кнопки «Подтвердить»

public String getApproveButtonToolTipText()
Возвращает текст подсказки, используемый в кнопке «Подтвердить». Если null, объект пользовательского интерфейса определит текст кнопки.
Возвращает:
текст подсказки для кнопки «Подтвердить»
См. также:
  • 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 - текст, используемый в кнопке подтверждения
См. также:
  • getApproveButtonText()
  • setDialogType(int)
  • showDialog(java.awt.Component, java.lang.String)

ПолучитьТекстКнопкиПодтверждения

public String getApproveButtonText()
Возвращает текст, используемый в кнопке подтверждения в диалоговом окне. Если null, объект пользовательского интерфейса определит текст кнопки. Обычно это "Открыть" или "Сохранить".
Возвращает:
текст, используемый в кнопке подтверждения
См. также:
  • 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()

addChoosableFileFilter

@BeanProperty(preferred=true, description="Adds a filter to the list of user choosable file filters.") public void addChoosableFileFilter(FileFilter filter)
Добавляет фильтр в список доступных пользователю фильтров файлов. Сведения о настройке режима выбора файла см. в setFileSelectionMode.
Parameters:
filter - добавляемый FileFilter для списка фильтров файлов
See Also:
  • getChoosableFileFilters()
  • removeChoosableFileFilter(javax.swing.filechooser.FileFilter)
  • resetChoosableFileFilters()
  • setFileSelectionMode(int)

removeChoosableFileFilter

public boolean removeChoosableFileFilter(FileFilter f)
Удаляет фильтр из списка доступных пользователю фильтров файлов. Возвращает true, если фильтр был удалён.
Parameters:
f - удаляемый фильтр файлов
Returns:
true, если фильтр был удалён, false — в противном случае
See Also:
  • addChoosableFileFilter(javax.swing.filechooser.FileFilter)
  • getChoosableFileFilters()
  • resetChoosableFileFilters()

resetChoosableFileFilters

public void resetChoosableFileFilters()
Сбрасывает список доступных фильтров файлов до исходного состояния. Как правило, это удаляет все добавленные фильтры, оставив при этом AcceptAll фильтр.
See Also:
  • addChoosableFileFilter(javax.swing.filechooser.FileFilter)
  • getChoosableFileFilters()
  • removeChoosableFileFilter(javax.swing.filechooser.FileFilter)

getAcceptAllFileFilter

@BeanProperty(bound=false) public FileFilter getAcceptAllFileFilter()
Возвращает AcceptAll фильтр файлов. Например, в Microsoft Windows это «Все файлы (*.*)».
Returns:
AcceptAll фильтр файлов

isAcceptAllFileFilterUsed

public boolean isAcceptAllFileFilterUsed()
Возвращает, используется ли AcceptAll FileFilter.
Возвращает:
true, если используется AcceptAll FileFilter
Since:
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)
Определяет, используется ли AcceptAll FileFilter в качестве доступного варианта в списке фильтров. Если false, фильтр файлов AcceptAll удаляется из списка доступных фильтров файлов. Если true, фильтр файлов AcceptAll станет активным фильтром файлов.
Параметры:
b - значение, определяющее, является ли фильтр файлов AcceptAll доступным вариантом в списке фильтров
Since:
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.
Parameters:
mode — тип отображаемых файлов:
  • JFileChooser.FILES_ONLY
  • JFileChooser.DIRECTORIES_ONLY
  • JFileChooser.FILES_AND_DIRECTORIES
Throws:
IllegalArgumentException — если mode — недопустимый режим выбора файлов
See Also:
  • getFileSelectionMode()

getFileSelectionMode

public int getFileSelectionMode()
Возвращает текущий режим выбора файлов. По умолчанию — JFilesChooser.FILES_ONLY.
Returns:
тип отображаемых файлов, один из следующих:
  • JFileChooser.FILES_ONLY
  • JFileChooser.DIRECTORIES_ONLY
  • JFileChooser.FILES_AND_DIRECTORIES
See Also:
  • setFileSelectionMode(int)

isFileSelectionEnabled

@BeanProperty(bound=false) public boolean isFileSelectionEnabled()
Удобный метод, определяющий, можно ли выбирать файлы в зависимости от текущего режима выбора файлов.
Returns:
true, если файлы можно выбрать, false в противном случае
See Also:
  • setFileSelectionMode(int)
  • getFileSelectionMode()

isDirectorySelectionEnabled

@BeanProperty(bound=false) public boolean isDirectorySelectionEnabled()
Удобный метод, определяющий, можно ли выбирать каталоги в зависимости от текущего режима выбора файлов.
Returns:
true, если каталоги можно выбрать, false в противном случае
See Also:
  • setFileSelectionMode(int)
  • getFileSelectionMode()

setMultiSelectionEnabled

@BeanProperty(description="Sets multiple file selection mode.") public void setMultiSelectionEnabled(boolean b)
Устанавливает возможность выбора нескольких файлов в файловом выборе.
Parameters:
b - true, если разрешено выбрать несколько файлов
See Also:
  • isMultiSelectionEnabled()

isMultiSelectionEnabled

public boolean isMultiSelectionEnabled()
Возвращает true, если разрешено выбрать несколько файлов.
Returns:
true, если разрешено выбрать несколько файлов
See Also:
  • setMultiSelectionEnabled(boolean)

isFileHidingEnabled

public boolean isFileHidingEnabled()
Возвращает true, если скрытые файлы не отображаются в файловом выборе; иначе возвращает false. Значение по умолчанию этого свойства может зависеть от используемой операционной системы.
Returns:
статус свойства скрытия файлов
See Also:
  • setFileHidingEnabled(boolean)

setFileHidingEnabled

@BeanProperty(preferred=true, description="Sets file hiding on or off.") public void setFileHidingEnabled(boolean b)
Включает или отключает скрытие файлов. Если true, скрытые файлы не отображаются в файловом выборе. Задача определения отображаемых файлов выполняется FileView.
Parameters:
b - значение boolean, определяющее включение скрытия файлов
See Also:
  • isFileHidingEnabled()

setFileFilter

@BeanProperty(preferred=true, description="Sets the File Filter used to filter out files of type.") public void setFileFilter(FileFilter filter)
Устанавливает текущий фильтр файлов. Фильтр файлов используется файловым выбором для фильтрации файлов из представления пользователя.
Parameters:
filter - новый текущий фильтр файлов для использования
See Also:
  • 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 - FileView, используемый для получения информации о пользовательском интерфейсе
См. также:
  • getFileView()

getFileView

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

getName

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

getDescription

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

getTypeDescription

public String getTypeDescription(File f)
Возвращает тип файла.
Parameters:
f - the File
Returns:
the String, содержащий описание типа файла для f
See Also:
  • FileView.getTypeDescription(java.io.File)

getIcon

public Icon getIcon(File f)
Возвращает значок для этого файла или типа файла в зависимости от системы.
Parameters:
f - the File
Returns:
the Icon для этого файла или типа файла
See Also:
  • FileView.getIcon(java.io.File)

isTraversable

public boolean isTraversable(File f)
Возвращает true, если файл (каталог) можно посетить. Возвращает false, если каталог нельзя пройти.
Parameters:
f - the File
Returns:
true, если файл/каталог можно пройти, в противном случае false
See Also:
  • FileView.isTraversable(java.io.File)

accept

public boolean accept(File f)
Возвращает true, если файл должен быть отображен.
Parameters:
f - the File
Returns:
true, если файл должен быть отображен, в противном случае false
See Also:
  • FileFilter.accept(java.io.File)

setFileSystemView

@BeanProperty(expert=true, description="Sets the FileSytemView used to get filesystem information.") public void setFileSystemView(FileSystemView fsv)
Устанавливает вид файловой системы, который JFileChooser использует для доступа и создания ресурсов файловой системы, таких как поиск дискеты и получение списка корневых дисков.
Parameters:
fsv - the new FileSystemView
See Also:
  • FileSystemView

getFileSystemView

public FileSystemView getFileSystemView()
Возвращает представление файловой системы.
Возвращает:
the FileSystemView объект
См. также:
  • 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)
Добавляет ActionListener к файловому обозревателю.
Параметры:
l - слушатель для добавления
См. также:
  • approveSelection()
  • cancelSelection()

removeActionListener

public void removeActionListener(ActionListener l)
Удаляет ActionListener из файлового обозревателя.
Параметры:
l - слушатель для удаления
См. также:
  • addActionListener(java.awt.event.ActionListener)

getActionListeners

@BeanProperty(bound=false) public ActionListener[] getActionListeners()
Возвращает массив всех обработчиков событий действия, зарегистрированных в этом файловом выборе.
Возвращает:
все ActionListener этого файлового выбора или пустой массив, если обработчики событий действия не зарегистрированы
С:
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()
Сбрасывает свойство UI на значение из текущей темы оформления.
Переопределяет:
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.
Overrides:
paramString в классе JComponent
Returns:
строковое представление этого JFileChooser

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
Получает AccessibleContext, связанный с этим JFileChooser. Для файловых диалогов AccessibleContext представлен в виде AccessibleJFileChooser. Новый экземпляр AccessibleJFileChooser создаётся при необходимости.
Specified by:
getAccessibleContext в интерфейсе Accessible
Overrides:
getAccessibleContext в классе Component
Returns:
AccessibleJFileChooser, служащий AccessibleContext для этого JFileChooser

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/javax/swing/JFileChooser.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API