Класс 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() |
Возвращает объект UI, реализующий 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() |
Сбрасывает свойство пользовательского интерфейса на значение из текущей темы оформления. |
Методы, объявленные в классе 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
- См. также:
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
- См. также:
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:
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, то диалоговое окно не зависит от видимого окна и размещается в позиции, зависящей от интерфейса пользователя, например, в центре экрана.
- Parameters:
-
parent- родительский компонент диалогового окна; может бытьnull -
approveButtonText- текстApproveButton - Returns:
- состояние возврата окна выбора файла при закрытии:
- JFileChooser.CANCEL_OPTION
- JFileChooser.APPROVE_OPTION
- JFileChooser.ERROR_OPTION, если произошла ошибка или диалоговое окно было закрыто
- Throws:
-
HeadlessException- если GraphicsEnvironment.isHeadless() возвращает true. - See Also:
создатьДиалог
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)
null, объект пользовательского интерфейса определит текст кнопки.- Параметры:
-
toolTipText- текст подсказки для кнопки «Подтвердить» - См. также:
Получить подсказку для кнопки «Подтвердить»
public String getApproveButtonToolTipText()
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)
- Параметры:
-
approveButtonText- текст, используемый в кнопке подтверждения - См. также:
ПолучитьТекстКнопкиПодтверждения
public String getApproveButtonText()
null, объект пользовательского интерфейса определит текст кнопки. Обычно это "Открыть" или "Сохранить".- Возвращает:
- текст, используемый в кнопке подтверждения
- См. также:
ПолучитьФильтрыФайлов
@BeanProperty(bound=false) public FileFilter[] getChoosableFileFilters()
- Возвращает:
- массив
FileFilter, содержащий все фильтры файлов, которые может выбрать пользователь - См. также:
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:
removeChoosableFileFilter
public boolean removeChoosableFileFilter(FileFilter f)
- Parameters:
-
f- удаляемый фильтр файлов - Returns:
- true, если фильтр был удалён, false — в противном случае
- See Also:
resetChoosableFileFilters
public void resetChoosableFileFilters()
AcceptAll фильтр.- See Also:
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
@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
- См. также:
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) JFileChooser, чтобы пользователь мог выбирать только файлы, только каталоги или и файлы, и каталоги. По умолчанию — 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)
- Parameters:
-
b- true, если разрешено выбрать несколько файлов - See Also:
isMultiSelectionEnabled
public boolean isMultiSelectionEnabled()
- Returns:
- true, если разрешено выбрать несколько файлов
- See Also:
isFileHidingEnabled
public boolean isFileHidingEnabled()
- Returns:
- статус свойства скрытия файлов
- See Also:
setFileHidingEnabled
@BeanProperty(preferred=true, description="Sets file hiding on or off.") public void setFileHidingEnabled(boolean b)
FileView.- Parameters:
-
b- значение boolean, определяющее включение скрытия файлов - See Also:
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
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)
- Parameters:
-
f- theFile - Returns:
- the
String, содержащий описание типа файла дляf - See Also:
getIcon
public Icon getIcon(File f)
- Parameters:
-
f- theFile - Returns:
- the
Iconдля этого файла или типа файла - See Also:
isTraversable
public boolean isTraversable(File f)
- Parameters:
-
f- theFile - Returns:
- true, если файл/каталог можно пройти, в противном случае false
- See Also:
accept
public boolean accept(File f)
- Parameters:
-
f- theFile - Returns:
- true, если файл должен быть отображен, в противном случае false
- See Also:
setFileSystemView
@BeanProperty(expert=true, description="Sets the FileSytemView used to get filesystem information.") public void setFileSystemView(FileSystemView fsv)
JFileChooser использует для доступа и создания ресурсов файловой системы, таких как поиск дискеты и получение списка корневых дисков.- Parameters:
-
fsv- the newFileSystemView - See Also:
getFileSystemView
public FileSystemView getFileSystemView()
- Возвращает:
- the
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()
- Возвращает:
- все
ActionListenerэтого файлового выбора или пустой массив, если обработчики событий действия не зарегистрированы - С:
- 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, который реализует L&F FileChooserUI
paramString
protected String paramString()
JFileChooser. Этот метод предназначен только для отладки, и содержимое и формат возвращаемой строки могут различаться между реализациями. Возвращаемая строка может быть пустой, но не может быть null.- Overrides:
-
paramStringв классеJComponent - Returns:
- строковое представление этого
JFileChooser
getAccessibleContext
@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
- 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