Класс 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 |
Создаёт JFileChooser, используя указанный File в качестве пути. |
JFileChooser |
Создаёт JFileChooser, используя текущий каталог и FileSystemView. |
JFileChooser |
Создаёт JFileChooser, используя указанный путь. |
JFileChooser |
Создаёт JFileChooser, используя указанный путь текущего каталога и FileSystemView. |
JFileChooser |
Создаёт JFileChooser, используя указанный FileSystemView. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
accept |
Возвращает true, если файл должен быть отображен. |
void |
addActionListener |
Добавляет ActionListener к файловому обозревателю. |
void |
addChoosableFileFilter |
Добавляет фильтр в список доступных фильтров файлов для пользователя. |
void |
approveSelection() |
Вызывается интерфейсом, когда пользователь нажимает кнопку «Подтвердить» (по умолчанию «Открыть» или «Сохранить»). |
void |
cancelSelection() |
Вызывается интерфейсом, когда пользователь нажимает кнопку «Отмена». |
void |
changeToParentDirectory() |
Изменяет каталог на родительский по отношению к текущему. |
protected JDialog |
createDialog |
Создаёт и возвращает новый JDialog, содержащий this, центрированный на parent в рамках parent. |
void |
ensureFileIsVisible |
Убеждается, что указанный файл отображается, а не скрыт. |
protected void |
fireActionPerformed |
Уведомляет всех слушателей, которые проявили интерес к уведомлениям об этом типе события. |
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 |
Возвращает описание файла. |
String |
getDialogTitle() |
Получает строку, которая отображается в строке заголовка JFileChooser. |
int |
getDialogType() |
Возвращает тип этого диалогового окна. |
boolean |
getDragEnabled() |
Получает значение свойства dragEnabled. |
FileFilter |
getFileFilter() |
Возвращает выбранный в данный момент фильтр файлов. |
int |
getFileSelectionMode() |
Возвращает текущий режим выбора файла. |
FileSystemView |
getFileSystemView() |
Возвращает представление файловой системы. |
FileView |
getFileView() |
Возвращает текущее представление файлов. |
Icon |
getIcon |
Возвращает значок для этого файла или типа файла в зависимости от системы. |
String |
getName |
Возвращает имя файла. |
File |
getSelectedFile() |
Возвращает выбранный файл. |
File[] |
getSelectedFiles() |
Возвращает список выбранных файлов, если в файловом выборе разрешена множественная выборка. |
String |
getTypeDescription |
Возвращает тип файла. |
FileChooserUI |
getUI() |
Получает объект пользовательского интерфейса, реализующий L&F для этого компонента. |
String |
getUIClassID() |
Возвращает строку, определяющую имя класса L&F, отображающего этот компонент. |
boolean |
isAcceptAllFileFilterUsed() |
Возвращает, используется ли AcceptAll FileFilter. |
boolean |
isDirectorySelectionEnabled() |
Удобный вызов, определяющий, можно ли выбирать каталоги в зависимости от текущего режима выбора файлов. |
boolean |
isFileHidingEnabled() |
Возвращает true, если скрытые файлы не отображаются в файловом выборе, иначе false. |
boolean |
isFileSelectionEnabled() |
Удобный вызов, определяющий, можно ли выбирать файлы в зависимости от текущего режима выбора файлов. |
boolean |
isMultiSelectionEnabled() |
Возвращает true, если можно выбрать несколько файлов. |
boolean |
isTraversable |
Возвращает true, если к файлу (каталогу) можно получить доступ. |
protected String |
paramString() |
Возвращает строковое представление этого JFileChooser. |
void |
removeActionListener |
Удаляет ActionListener из файлового выбора. |
boolean |
removeChoosableFileFilter |
Удаляет фильтр из списка доступных пользователю фильтров файлов. |
void |
rescanCurrentDirectory() |
Указывает UI на необходимость повторного сканирования списка файлов из текущей директории. |
void |
resetChoosableFileFilters() |
Сбрасывает список фильтров файлов в исходное состояние. |
void |
setAcceptAllFileFilterUsed |
Определяет, используется ли AcceptAll FileFilter в качестве доступного варианта в списке фильтров. |
void |
setAccessory |
Устанавливает дополнительный компонент. |
void |
setApproveButtonMnemonic |
Устанавливает мнемонический символ для кнопки подтверждения. |
void |
setApproveButtonMnemonic |
Устанавливает мнемонический код (числовой) для кнопки подтверждения. |
void |
setApproveButtonText |
Устанавливает текст, используемый в ApproveButton в FileChooserUI. |
void |
setApproveButtonToolTipText |
Устанавливает текст всплывающей подсказки для ApproveButton. |
void |
setControlButtonsAreShown |
Устанавливает свойство, указывающее, отображаются ли кнопки подтверждения и отмены в файловом выборе. |
void |
setCurrentDirectory |
Устанавливает текущую директорию. |
void |
setDialogTitle |
Устанавливает строку, отображаемую в строке заголовка окна JFileChooser. |
void |
setDialogType |
Устанавливает тип этого диалогового окна. |
void |
setDragEnabled |
Устанавливает свойство dragEnabled, которое должно быть true, чтобы включить автоматическую обработку перетаскивания (первая часть перетаскивания и падения) для этого компонента. |
void |
setFileFilter |
Устанавливает текущий фильтр файлов. |
void |
setFileHidingEnabled |
Устанавливает скрытие файлов включенным или выключенным. |
void |
setFileSelectionMode |
Устанавливает JFileChooser, чтобы пользователь мог выбирать только файлы, только каталоги или и файлы, и каталоги. |
void |
setFileSystemView |
Устанавливает вид файловой системы, используемый JFileChooser для доступа к ресурсам файловой системы и создания их, например, для поиска дисковода гибких дисков и получения списка корневых дисков. |
void |
setFileView |
Устанавливает вид файла, используемый для получения информации об интерфейсе пользователя, например, иконки, представляющей файл, или описания типа файла. |
void |
setMultiSelectionEnabled |
Устанавливает файловый выборщик для разрешения выбора нескольких файлов. |
void |
setSelectedFile |
Устанавливает выбранный файл. |
void |
setSelectedFiles |
Устанавливает список выбранных файлов, если файловый выборщик настроен на разрешение выбора нескольких файлов. |
protected void |
setup |
Выполняет общую инициализацию и настройку конструктора. |
int |
showDialog |
Выводит диалоговое окно пользовательского файлового выбора с пользовательской кнопкой подтверждения. |
int |
showOpenDialog |
Выводит диалоговое окно "Открыть файл" для выбора файла. |
int |
showSaveDialog |
Выводит диалоговое окно "Сохранить файл" для выбора файла. |
void |
updateUI() |
Сбрасывает свойство интерфейса пользователя до значения из текущей темы оформления. |
Methods declared in class 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
Подробное описание полей
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
- См. также:
Включена множественная выборка
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
- См. также:
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
- См. также:
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, используя заданный путь. Передача пустой строки приводит к тому, что диалог выбора файла указывает на стандартный каталог пользователя. Этот стандартный каталог зависит от операционной системы. Обычно это папка "Мои документы" в Windows и домашний каталог пользователя в Unix.- Parameters:
-
currentDirectoryPath- aString, задающий путь к файлу или каталогу
JFileChooser
public JFileChooser(File currentDirectory)
JFileChooser, используя заданный File в качестве пути. Передача пустого файла приводит к тому, что диалог выбора файла указывает на стандартный каталог пользователя. Этот стандартный каталог зависит от операционной системы. Обычно это папка "Мои документы" в Windows и домашний каталог пользователя в Unix.- Parameters:
-
currentDirectory- aFileобъект, определяющий путь к файлу или каталогу
JFileChooser
public JFileChooser(FileSystemView fsv)
JFileChooser, используя заданный FileSystemView.- Parameters:
-
fsv- aFileSystemView
JFileChooser
public JFileChooser(File currentDirectory, FileSystemView fsv)
JFileChooser, используя заданный текущий каталог и FileSystemView.- Parameters:
-
currentDirectory- aFileобъект, определяющий путь к файлу или каталогу -
fsv- aFileSystemView
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 должно быть установлено на ненулевое значение, чтобы перетаскивание работало. Значение по умолчанию свойства dragEnabled — false. При включённой автоматической обработке перетаскивания большинство стилей оформления начинают операцию перетаскивания и перемещения всякий раз, когда пользователь нажимает кнопку мыши над элементом и перемещает мышь на несколько пикселей. Установка этого свойства в true может поэтому иметь тонкое влияние на поведение выбора.
Некоторые стили оформления могут не поддерживать автоматическое перетаскивание и перемещение; они проигнорируют это свойство. Вы можете обойти такие стили оформления, изменив компонент таким образом, чтобы он напрямую вызывал метод exportAsDrag объекта TransferHandler.
- Parameters:
-
b- значение для установки свойстваdragEnabled - Throws:
-
HeadlessException- еслиbравноtrueиGraphicsEnvironment.isHeadless()возвращаетtrue - Since:
- 1.4
- See Also:
getDragEnabled
public boolean getDragEnabled()
dragEnabled. - Возвращает:
- значение свойства
dragEnabled - С момента:
- 1.4
- См. также:
getSelectedFile
public File getSelectedFile()
setSelectedFile или с помощью пользовательского действия, например, введя имя файла в пользовательском интерфейсе или выбрав его из списка в пользовательском интерфейсе.- Возвращает:
- выбранный файл
- См. также:
setSelectedFile
@BeanProperty(preferred=true) public void setSelectedFile(File file)
- Параметры:
-
file- выбранный файл - См. также:
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()
- Возвращает:
- текущую директорию
- См. также:
Установить текущую директорию
@BeanProperty(preferred=true, description="The directory that the JFileChooser is showing files of.") public void setCurrentDirectory(File dir)
null устанавливает файловый выборщик на указание по умолчанию у пользователя. Это значение зависит от операционной системы. Обычно это папка "Мои документы" в Windows и домашняя директория пользователя в Unix. Если переданный файл currentDirectory не является директорией, то родительская директория файла будет использоваться в качестве текущей. Если родительская директория недоступна, то будет выполнено возвратное движение по дереву родительских директорий, пока не будет найдена доступная директория или не будет достигнут корень файловой системы.- Параметры:
-
dir- текущая директория, на которую следует указывать - См. также:
Перейти в родительскую директорию
public void changeToParentDirectory()
- См. также:
Пересканировать текущую директорию
public void rescanCurrentDirectory()
Обеспечить видимость файла
public void ensureFileIsVisible(File f)
- Параметры:
-
f- объект File
showOpenDialog
public int showOpenDialog(Component parent) throws HeadlessException
- Параметры:
-
parent- родительский компонент диалогового окна, может бытьnull; см.showDialogдля подробностей - Возвращает:
- состояние возврата файлового выборщика при закрытии:
- JFileChooser.CANCEL_OPTION
- JFileChooser.APPROVE_OPTION
- JFileChooser.ERROR_OPTION, если произошла ошибка или диалоговое окно было закрыто
- Исключения:
-
HeadlessException- если GraphicsEnvironment.isHeadless() возвращает true. - См. также:
showSaveDialog
public int showSaveDialog(Component parent) throws HeadlessException
- Параметры:
-
parent- родительский компонент диалогового окна, может бытьnull; см.showDialogдля получения подробной информации - Возвращает:
- состояние возврата выбора файла при закрытии:
- JFileChooser.CANCEL_OPTION
- JFileChooser.APPROVE_OPTION
- JFileChooser.ERROR_OPTION, если произошла ошибка или диалоговое окно было закрыто
- Исключения:
-
HeadlessException- если GraphicsEnvironment.isHeadless() возвращает true. - См. также:
showDialog
public int showDialog(Component parent, String approveButtonText) throws HeadlessException
filechooser.showDialog(parentFrame, "Run Application");Аналогично, следующий код делает то же самое:
JFileChooser chooser = new JFileChooser(null);
chooser.setApproveButtonText("Run Application");
chooser.showDialog(parentFrame, null);
Аргумент parent определяет два аспекта: фрейм, от которого зависит диалоговое окно, и компонент, положение которого должен учитывать виджет при размещении диалогового окна. Если родительским элементом является объект Frame (например, JFrame), то диалоговое окно зависит от фрейма, и виджет размещает его относительно фрейма (например, по центру над фреймом). Если родительским элементом является компонент, то диалоговое окно зависит от фрейма, содержащего компонент, и позиционируется относительно компонента (например, по центру над компонентом). Если родительским элементом является null, то диалоговое окно не зависит от видимого окна и размещается в позиции, зависящей от виджета, например, в центре экрана.
- Параметры:
-
parent- родительский компонент диалогового окна; может бытьnull -
approveButtonText- текстApproveButton - Возвращаемое значение:
- состояние возврата диалогового окна выбора файла при закрытии:
- JFileChooser.CANCEL_OPTION
- JFileChooser.APPROVE_OPTION
- JFileChooser.ERROR_OPTION, если произошла ошибка или диалоговое окно было закрыто
- Исключение:
-
HeadlessException- если GraphicsEnvironment.isHeadless() возвращает true. - См. также:
создатьДиалог
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
- См. также:
getControlButtonsAreShown
public boolean getControlButtonsAreShown()
controlButtonsAreShown. - Возвращает:
- значение свойства
controlButtonsAreShown - С:
- 1.3
- См. также:
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
- См. также:
Тип диалогового окна
public int getDialogType()
JFileChooser.OPEN_DIALOG.- Возвращает:
- тип отображаемого диалогового окна:
- JFileChooser.OPEN_DIALOG
- JFileChooser.SAVE_DIALOG
- JFileChooser.CUSTOM_DIALOG
- См. также:
Установить тип диалогового окна
@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не допустимо - См. также:
Установить заголовок диалогового окна
@BeanProperty(preferred=true, description="The title of the JFileChooser dialog window.") public void setDialogTitle(String dialogTitle)
JFileChooser.- Параметры:
-
dialogTitle- новыйStringдля строки заголовка - См. также:
Получить заголовок диалогового окна
public String getDialogTitle()
JFileChooser.- Возвращает:
- строку из строки заголовка окна
JFileChooser - См. также:
УстановитьПодсказкуКнопкиОдобрения
@BeanProperty(preferred=true, description="The tooltip text for the ApproveButton.") public void setApproveButtonToolTipText(String toolTipText)
ApproveButton. Если null, объект пользовательского интерфейса определит текст кнопки.- Параметры:
-
toolTipText- текст подсказки для кнопки одобрения - См. также:
ПолучитьПодсказкуКнопкиОдобрения
public String getApproveButtonToolTipText()
ApproveButton. Если null, объект пользовательского интерфейса определит текст кнопки.- Возвращает:
- текст подсказки для кнопки одобрения
- См. также:
ПолучитьМемоКлючКнопкиОдобрения
public int getApproveButtonMnemonic()
- Возвращает:
- целочисленное значение для мнемоники
- См. также:
УстановитьМемоКлючКнопкиОдобрения
@BeanProperty(preferred=true, description="The mnemonic key accelerator for the ApproveButton.") public void setApproveButtonMnemonic(int mnemonic)
- Параметры:
-
mnemonic- целочисленное значение для мнемоники - См. также:
УстановитьМемоКлючКнопкиОдобрения
public void setApproveButtonMnemonic(char mnemonic)
- Параметры:
-
mnemonic- символьное значение для мнемоники - См. также:
УстановитьТекстКнопкиОдобрения
@BeanProperty(preferred=true, description="The text that goes in the ApproveButton.") public void setApproveButtonText(String approveButtonText)
ApproveButton в FileChooserUI.- Параметры:
-
approveButtonText- текст, используемый вApproveButton - См. также:
ПолучитьТекстКнопкиОдобрения
public String getApproveButtonText()
ApproveButton в FileChooserUI. Если null, объект пользовательского интерфейса определит текст кнопки. Обычно это "Открыть" или "Сохранить".- Возвращает:
- текст, используемый в
ApproveButton - См. также:
ПолучитьФильтрыФайлов
@BeanProperty(bound=false) public FileFilter[] getChoosableFileFilters()
- Возвращает:
- массив
FileFilterсодержащий все фильтры файлов, выбираемые пользователем - См. также:
Добавить фильтр выбора файла
@BeanProperty(preferred=true, description="Adds a filter to the list of user choosable file filters.") public void addChoosableFileFilter(FileFilter filter)
setFileSelectionMode.- Параметры:
-
filter- добавляемыйFileFilterв список фильтров выбора файлов - См. также:
Удалить фильтр выбора файла
public boolean removeChoosableFileFilter(FileFilter f)
- Параметры:
-
f- удаляемый фильтр файлов - Возвращает:
- true, если фильтр был удалён, иначе false
- См. также:
Сбросить фильтры выбора файлов
public void resetChoosableFileFilters()
AcceptAll.Получить фильтр "Все файлы"
@BeanProperty(bound=false) public FileFilter getAcceptAllFileFilter()
- Возвращает:
- фильтр "Все файлы"
isAcceptAllFileFilterUsed
public boolean isAcceptAllFileFilterUsed()
AcceptAll FileFilter. - Возвращает:
- true, если
AcceptAll FileFilterиспользуется - С:
- 1.3
- См. также:
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доступным вариантом в списке фильтров - С:
- 1.3
- См. также:
getAccessory
public JComponent getAccessory()
- Возвращает:
- вспомогательный компонент JFileChooser, или null
- См. также:
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) JFilesChooser.FILES_ONLY. - Parameters:
-
mode- тип отображаемых файлов:- JFileChooser.FILES_ONLY
- JFileChooser.DIRECTORIES_ONLY
- JFileChooser.FILES_AND_DIRECTORIES
- Throws:
-
IllegalArgumentException- еслиmodeявляется недопустимым режимом выбора файлов - See Also:
getFileSelectionMode
public int getFileSelectionMode()
JFilesChooser.FILES_ONLY.- Returns:
- тип отображаемых файлов:
- JFileChooser.FILES_ONLY
- JFileChooser.DIRECTORIES_ONLY
- JFileChooser.FILES_AND_DIRECTORIES
- See Also:
isFileSelectionEnabled
@BeanProperty(bound=false) public boolean isFileSelectionEnabled()
- Returns:
- true, если выбор файлов разрешен, false в противном случае
- See Also:
isDirectorySelectionEnabled
@BeanProperty(bound=false) public boolean isDirectorySelectionEnabled()
- Returns:
- true, если выбор каталогов разрешен, false в противном случае
- See Also:
setMultiSelectionEnabled
@BeanProperty(description="Sets multiple file selection mode.") public void setMultiSelectionEnabled(boolean b)
- Параметры:
-
b- true, если можно выбрать несколько файлов - См. также:
isMultiSelectionEnabled
public boolean isMultiSelectionEnabled()
- Возвращает:
- true, если можно выбрать несколько файлов
- См. также:
isFileHidingEnabled
public boolean isFileHidingEnabled()
- Возвращает:
- состояние свойства скрытия файлов
- См. также:
setFileHidingEnabled
@BeanProperty(preferred=true, description="Sets file hiding on or off.") public void setFileHidingEnabled(boolean b)
FileView.- Параметры:
-
b- логическое значение, определяющее включение скрытия файлов - См. также:
setFileFilter
@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()
- Возвращает:
- текущий фильтр файлов
- См. также:
setFileView
@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()
- Возвращает:
- текущий просмотрщик файлов
- См. также:
getName
public String getName(File f)
- Параметры:
-
f-File - Возвращает:
- строку, содержащую имя файла для
f - См. также:
getDescription
public String getDescription(File f)
- Параметры:
-
f-File - Возвращает:
- строку, содержащую описание файла для
f - См. также:
getTypeDescription
public String getTypeDescription(File f)
- Параметры:
-
f- theFile - Возвращает:
- the
String, содержащий описание типа файла дляf - См. также:
getIcon
public Icon getIcon(File f)
- Параметры:
-
f- theFile - Возвращает:
- the
Iconдля данного файла или типа файла - См. также:
isTraversable
public boolean isTraversable(File f)
- Параметры:
-
f- theFile - Возвращает:
- true, если файл/каталог можно перейти, в противном случае false
- См. также:
accept
public boolean accept(File f)
- Параметры:
-
f- theFile - Возвращает:
- true, если файл должен быть отображен, в противном случае false
- См. также:
setFileSystemView
@BeanProperty(expert=true, description="Sets the FileSytemView used to get filesystem information.") public void setFileSystemView(FileSystemView fsv)
JFileChooser для доступа и создания ресурсов файловой системы, таких как поиск дискеты и получение списка корневых дисков.- Параметры:
-
fsv- the newFileSystemView - См. также:
getFileSystemView
public FileSystemView getFileSystemView()
- Возвращает:
- объект
FileSystemView - См. также:
approveSelection
public void approveSelection()
APPROVE_SELECTION- См. также:
cancelSelection
public void cancelSelection()
CANCEL_SELECTION- См. также:
addActionListener
public void addActionListener(ActionListener l)
ActionListener к файловому просмотру.- Параметры:
-
l- слушатель, который нужно добавить - См. также:
removeActionListener
public void removeActionListener(ActionListener l)
ActionListener из файлового просмотру.- Параметры:
-
l- слушатель, который нужно удалить - См. также:
getActionListeners
@BeanProperty(bound=false) public ActionListener[] getActionListeners()
- Возвращает:
- все обработчики событий этого файлового выбора или пустой массив, если обработчики событий не зарегистрированы
- С тех пор:
- 1.4
- См. также:
fireActionPerformed
protected void fireActionPerformed(String command)
command. - Параметры:
-
command- строка, которая может указывать команду, связанную с событием - См. также:
updateUI
public void updateUI()
- Переопределяет:
-
updateUIв классеJComponent - См. также:
getUIClassID
@BeanProperty(bound=false, expert=true, description="A string that specifies the name of the L&F class.") public String getUIClassID()
- Переопределяет:
-
getUIClassIDв классеJComponent - Возвращает:
- строку "FileChooserUI"
- См. также:
getUI
@BeanProperty(bound=false) public FileChooserUI getUI()
- Переопределяет:
-
getUIв классеJComponent - Возвращает:
- объект FileChooserUI, реализующий FileChooserUI L&F
paramString
protected String paramString()
JFileChooser. Этот метод предназначен только для отладки, и содержимое и формат возвращаемой строки могут различаться между реализациями. Возвращаемая строка может быть пустой, но не может быть null.- Переопределяет:
-
paramStringв классеJComponent - Возвращает:
- строковое представление этого
JFileChooser
getAccessibleContext
@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
- Определено в:
-
getAccessibleContextв интерфейсеAccessible - Переопределяет:
-
getAccessibleContextв классеComponent - Возвращает:
- AccessibleJFileChooser, который служит AccessibleContext этого JFileChooser
© 1993, 2021, 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/17/docs/api/java.desktop/javax/swing/JFileChooser.html