- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- javax.swing.JComponent
-
- javax.swing.JFileChooser
-
- All Implemented Interfaces:
-
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教程”中的“ How to Use File Choosers”部分。以下代码弹出用户主目录的文件选择器,仅查看.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's Threading Policy 。
- 从以下版本开始:
- 1.2
- 另请参见:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class 描述 protected class
JFileChooser.AccessibleJFileChooser
该类实现JFileChooser
类的可访问性支持。-
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer
-
Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent
-
-
Field Summary
-
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
-
Fields inherited from class javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
-
-
构造方法摘要
构造方法 Constructor 描述 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
。
-
方法摘要
所有方法 接口方法 具体的方法 Modifier and Type 方法 描述 boolean
accept(File f)
如果文件应该显示,则返回true。void
addActionListener(ActionListener l)
添加一个ActionListener
到文件选择器。void
addChoosableFileFilter(FileFilter filter)
将一个过滤器添加到用户可选择的文件过滤器列表中。void
approveSelection()
当用户点击“批准”按钮(默认情况下标记为“打开”或“保存”)时,由用户名称调用。void
cancelSelection()
当用户选择“取消”按钮时,由UI调用。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()
获取与此JFileChooser关联的AccessibleContext。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()
获取实现此组件的L&F的UI对象。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
的字符串表示JFileChooser
。void
removeActionListener(ActionListener l)
从文件选择器中删除一个ActionListener
。boolean
removeChoosableFileFilter(FileFilter f)
从用户可选择的文件过滤器列表中删除一个过滤器。void
rescanCurrentDirectory()
告诉用户界面从当前目录重新扫描其文件列表。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)
设置用于检索UI信息的文件视图,例如表示文件的图标或文件的类型说明。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()
将UI属性重置为当前外观的值。-
Methods inherited from class 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, 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
-
Methods inherited from class 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
-
Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, 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
-
-
-
-
字段详细信息
-
OPEN_DIALOG
public static final int OPEN_DIALOG
键入值表示JFileChooser
支持“打开”文件操作。- 另请参见:
- Constant Field Values
-
SAVE_DIALOG
public static final int SAVE_DIALOG
键入值表示JFileChooser
支持“保存”文件操作。- 另请参见:
- Constant Field Values
-
CUSTOM_DIALOG
public static final int CUSTOM_DIALOG
键入值,表示JFileChooser
支持开发人员指定的文件操作。- 另请参见:
- Constant Field Values
-
CANCEL_OPTION
public static final int CANCEL_OPTION
如果选择了取消,则返回值。- 另请参见:
- Constant Field Values
-
APPROVE_OPTION
public static final int APPROVE_OPTION
如果批准(yes,ok),则返回值。- 另请参见:
- Constant Field Values
-
ERROR_OPTION
public static final int ERROR_OPTION
返回值,如果发生错误。- 另请参见:
- Constant Field Values
-
FILES_ONLY
public static final int FILES_ONLY
仅显示文件的指令。- 另请参见:
- Constant Field Values
-
DIRECTORIES_ONLY
public static final int DIRECTORIES_ONLY
仅显示目录的指令。- 另请参见:
- Constant Field Values
-
FILES_AND_DIRECTORIES
public static final int FILES_AND_DIRECTORIES
显示文件和目录的指令。- 另请参见:
- Constant Field Values
-
CANCEL_SELECTION
public static final String CANCEL_SELECTION
取消当前选择的指令。- 另请参见:
- Constant Field Values
-
APPROVE_SELECTION
public static final String APPROVE_SELECTION
批准当前选择的指令(与按yes或ok相同)。- 另请参见:
- Constant Field Values
-
APPROVE_BUTTON_TEXT_CHANGED_PROPERTY
public static final String APPROVE_BUTTON_TEXT_CHANGED_PROPERTY
标识批准文本的更改(是,确定)按钮。- 另请参见:
- Constant Field Values
-
APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY
public static final String APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY
标识批准(是,确定)按钮的工具提示文本中的更改。- 另请参见:
- Constant Field Values
-
APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY
public static final String APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY
识别助记符的更改(yes,ok)按钮。- 另请参见:
- Constant Field Values
-
CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
public static final String CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
指示显示控制按钮。- 另请参见:
- Constant Field Values
-
DIRECTORY_CHANGED_PROPERTY
public static final String DIRECTORY_CHANGED_PROPERTY
标识用户的目录更改。- 另请参见:
- Constant Field Values
-
SELECTED_FILE_CHANGED_PROPERTY
public static final String SELECTED_FILE_CHANGED_PROPERTY
标识用户单文件选择的变化。- 另请参见:
- Constant Field Values
-
SELECTED_FILES_CHANGED_PROPERTY
public static final String SELECTED_FILES_CHANGED_PROPERTY
标识用户多文件选择的变化。- 另请参见:
- Constant Field Values
-
MULTI_SELECTION_ENABLED_CHANGED_PROPERTY
public static final String MULTI_SELECTION_ENABLED_CHANGED_PROPERTY
启用多文件选择。- 另请参见:
- Constant Field Values
-
FILE_SYSTEM_VIEW_CHANGED_PROPERTY
public static final String FILE_SYSTEM_VIEW_CHANGED_PROPERTY
说使用不同的对象来查找系统上可用的驱动器。- 另请参见:
- Constant Field Values
-
FILE_VIEW_CHANGED_PROPERTY
public static final String FILE_VIEW_CHANGED_PROPERTY
说使用不同的对象来检索文件信息。- 另请参见:
- Constant Field Values
-
FILE_HIDING_CHANGED_PROPERTY
public static final String FILE_HIDING_CHANGED_PROPERTY
标识显示隐藏文件属性的更改。- 另请参见:
- Constant Field Values
-
FILE_FILTER_CHANGED_PROPERTY
public static final String FILE_FILTER_CHANGED_PROPERTY
用户更改了要显示的文件种类。- 另请参见:
- Constant Field Values
-
FILE_SELECTION_MODE_CHANGED_PROPERTY
public static final String FILE_SELECTION_MODE_CHANGED_PROPERTY
识别选择类型的变化(单个,多个等)。- 另请参见:
- Constant Field Values
-
ACCESSORY_CHANGED_PROPERTY
public static final String ACCESSORY_CHANGED_PROPERTY
说使用不同的附件组件(例如,预览文件)。- 另请参见:
- Constant Field Values
-
ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY
public static final String ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY
标识是否使用AcceptAllFileFilter。- 另请参见:
- Constant Field Values
-
DIALOG_TITLE_CHANGED_PROPERTY
public static final String DIALOG_TITLE_CHANGED_PROPERTY
标识对话标题中的更改。- 另请参见:
- Constant Field Values
-
DIALOG_TYPE_CHANGED_PROPERTY
public static final String DIALOG_TYPE_CHANGED_PROPERTY
标识显示文件类型的变化(仅文件,仅目录,或文件和目录)。- 另请参见:
- Constant Field Values
-
CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY
public static final String CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY
标识用户可以选择的预定义文件过滤器列表中的更改。- 另请参见:
- Constant Field Values
-
accessibleContext
protected AccessibleContext accessibleContext
AccessibleContext
与此JFileChooser
相关联
-
-
构造方法详细信息
-
JFileChooser
public JFileChooser()
构造一个指向用户默认目录的JFileChooser
。 这个默认值取决于操作系统。 它通常是Windows上的“我的文档”文件夹,Unix上的用户主目录。
-
JFileChooser
public JFileChooser(String currentDirectoryPath)
使用给定路径构造一个JFileChooser
。null
字符串会导致文件选择器指向用户的默认目录。 这个默认值取决于操作系统。 它通常是Windows上的“我的文档”文件夹,Unix上的用户主目录。- 参数
-
currentDirectoryPath
- aString
给出文件或目录的路径
-
JFileChooser
public JFileChooser(File currentDirectory)
构造一个JFileChooser
使用给定的File
作为路径。null
文件导致文件选择器指向用户的默认目录。 这个默认值取决于操作系统。 它通常是Windows上的“我的文档”文件夹,Unix上的用户主目录。- 参数
-
currentDirectory
- 一个File
对象,指定文件或目录的路径
-
JFileChooser
public JFileChooser(FileSystemView fsv)
构造一个JFileChooser
使用给定的FileSystemView
。- 参数
-
fsv
- aFileSystemView
-
JFileChooser
public JFileChooser(File currentDirectory, FileSystemView fsv)
构造一个JFileChooser
使用给定的当前目录和FileSystemView
。- 参数
-
currentDirectory
- 一个File
对象,指定文件或目录的路径 -
fsv
- aFileSystemView
-
JFileChooser
public JFileChooser(String currentDirectoryPath, FileSystemView fsv)
使用给定的当前目录路径构建一个JFileChooser
和FileSystemView
。- 参数
-
currentDirectoryPath
- 一个String
指定文件或目录的路径 -
fsv
- aFileSystemView
-
-
方法详细信息
-
setup
protected void setup(FileSystemView view)
执行常见的构造函数初始化和设置。- 参数
-
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
。- 参数
-
b
- 设置dragEnabled
属性的值 - 异常
-
HeadlessException
- 如果b
是true
和GraphicsEnvironment.isHeadless()
返回true
- 从以下版本开始:
- 1.4
- 另请参见:
-
GraphicsEnvironment.isHeadless()
,getDragEnabled()
,JComponent.setTransferHandler(javax.swing.TransferHandler)
,TransferHandler
-
getDragEnabled
public boolean getDragEnabled()
获取dragEnabled
属性的值。- 结果
-
的价值
dragEnabled
属性 - 从以下版本开始:
- 1.4
- 另请参见:
-
setDragEnabled(boolean)
-
getSelectedFile
public File getSelectedFile()
返回所选文件。 这可以由程序员通过setSelectedFile
或用户操作设置,例如在UI中键入文件名或从UI中的列表中选择文件。- 结果
- 所选文件
- 另请参见:
-
setSelectedFile(java.io.File)
-
setSelectedFile
@BeanProperty(preferred=true) public void setSelectedFile(File file)
设置所选文件。 如果文件的父目录不是当前目录,则将当前目录更改为文件的父目录。- 参数
-
file
- 所选文件 - 另请参见:
-
getSelectedFile()
-
getSelectedFiles
public File[] getSelectedFiles()
如果文件选择器设置为允许多个选择,则返回所选文件的列表。- 结果
-
一组选定的
File
s
-
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)
-
setCurrentDirectory
@BeanProperty(preferred=true, description="The directory that the JFileChooser is showing files of.") public void setCurrentDirectory(File dir)
设置当前目录。null
将文件选择器设置为指向用户的默认目录。 这个默认值取决于操作系统。 它通常是Windows上的“我的文档”文件夹,Unix上的用户主目录。 如果以currentDirectory
传入的文件不是目录,则该文件的父项将被用作currentDirectory。 如果父进程不可遍历,那么它将向上移动父树,直到找到可遍历目录,或者触及文件系统的根目录。- 参数
-
dir
- 指向的当前目录 - 另请参见:
-
getCurrentDirectory()
-
changeToParentDirectory
public void changeToParentDirectory()
将要设置的目录更改为当前目录的父级。- 另请参见:
-
getCurrentDirectory()
-
rescanCurrentDirectory
public void rescanCurrentDirectory()
告诉用户界面从当前目录重新扫描其文件列表。
-
ensureFileIsVisible
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
,则对话框将不依赖于可视窗口,并且它被放置在与外观和感觉相关的位置,例如屏幕中心。- 参数
-
parent
- 对话框的父组件; 可以是null
-
approveButtonText
-该文ApproveButton
- 结果
-
弹出窗口中文件选择器的返回状态:
- JFileChooser.CANCEL_OPTION
- JFileChooser.APPROVE_OPTION
- JFileChooser.ERROR_OPTION如果发生错误或对话框被关闭
- 异常
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless()返回true。 - 另请参见:
-
GraphicsEnvironment.isHeadless()
-
createDialog
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
-
getDialogType
public int getDialogType()
返回此对话框的类型。 默认值为JFileChooser.OPEN_DIALOG
。- 结果
-
要显示的对话框类型:
- JFileChooser.OPEN_DIALOG
- JFileChooser.SAVE_DIALOG
- JFileChooser.CUSTOM_DIALOG
- 另请参见:
-
setDialogType(int)
-
setDialogType
@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)
-
setDialogTitle
@BeanProperty(preferred=true, description="The title of the JFileChooser dialog window.") public void setDialogTitle(String dialogTitle)
设置JFileChooser
窗口标题栏中的字符串。- 参数
-
dialogTitle
- 标题栏的新String
- 另请参见:
-
getDialogTitle()
-
getDialogTitle
public String getDialogTitle()
获取JFileChooser
的标题栏中的字符串。- 结果
-
字符串从
JFileChooser
窗口的标题栏 - 另请参见:
-
setDialogTitle(java.lang.String)
-
setApproveButtonToolTipText
@BeanProperty(preferred=true, description="The tooltip text for the ApproveButton.") public void setApproveButtonToolTipText(String toolTipText)
设置ApproveButton
使用的工具提示文本。 如果是null
,UI对象将确定按钮的文本。- 参数
-
toolTipText
- 批准按钮的工具提示文本 - 另请参见:
-
setApproveButtonText(java.lang.String)
,setDialogType(int)
,showDialog(java.awt.Component, java.lang.String)
-
getApproveButtonToolTipText
public String getApproveButtonToolTipText()
返回ApproveButton
使用的工具提示文本。 如果null
,UI对象将确定按钮的文本。- 结果
- 用于批准按钮的工具提示文本
- 另请参见:
-
setApproveButtonText(java.lang.String)
,setDialogType(int)
,showDialog(java.awt.Component, java.lang.String)
-
getApproveButtonMnemonic
public int getApproveButtonMnemonic()
返回批准按钮的助记符。- 结果
- 助记键的整数值
- 另请参见:
-
setApproveButtonMnemonic(int)
-
setApproveButtonMnemonic
@BeanProperty(preferred=true, description="The mnemonic key accelerator for the ApproveButton.") public void setApproveButtonMnemonic(int mnemonic)
使用数字键码设置批准按钮的助记符。- 参数
-
mnemonic
- 助记键的整数值 - 另请参见:
-
getApproveButtonMnemonic()
-
setApproveButtonMnemonic
public void setApproveButtonMnemonic(char mnemonic)
使用字符设置批准按钮的助记符。- 参数
-
mnemonic
- 助记键的字符值 - 另请参见:
-
getApproveButtonMnemonic()
-
setApproveButtonText
@BeanProperty(preferred=true, description="The text that goes in the ApproveButton.") public void setApproveButtonText(String approveButtonText)
设置在使用的文本ApproveButton
在FileChooserUI
。- 参数
-
approveButtonText
-在使用的文本ApproveButton
- 另请参见:
-
getApproveButtonText()
,setDialogType(int)
,showDialog(java.awt.Component, java.lang.String)
-
getApproveButtonText
public String getApproveButtonText()
返回ApproveButton
中的FileChooserUI
使用的文本。 如果是null
,UI对象将确定按钮的文本。 通常,这将是“打开”或“保存”。- 结果
-
文字用于
ApproveButton
- 另请参见:
-
setApproveButtonText(java.lang.String)
,setDialogType(int)
,showDialog(java.awt.Component, java.lang.String)
-
getChoosableFileFilters
@BeanProperty(bound=false) public FileFilter[] getChoosableFileFilters()
获取用户可选择的文件过滤器列表。- 结果
-
一个包含所有
FileFilter
文件过滤器的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
。- 参数
-
filter
- 要添加到FileFilter
的文件过滤器列表中的FileFilter
- 另请参见:
-
getChoosableFileFilters()
,removeChoosableFileFilter(javax.swing.filechooser.FileFilter)
,resetChoosableFileFilters()
,setFileSelectionMode(int)
-
removeChoosableFileFilter
public boolean removeChoosableFileFilter(FileFilter f)
从用户可选择的文件过滤器列表中删除一个过滤器。 如果文件过滤器被删除,则返回true。- 参数
-
f
- 要删除的文件过滤器 - 结果
- 如果文件过滤器被删除,则为true,否则为false
- 另请参见:
-
addChoosableFileFilter(javax.swing.filechooser.FileFilter)
,getChoosableFileFilters()
,resetChoosableFileFilters()
-
resetChoosableFileFilters
public void resetChoosableFileFilters()
将可选择的文件过滤器列表重置为其启动状态。 通常,这将删除所有添加的文件过滤器,同时保留AcceptAll
文件过滤器。
-
getAcceptAllFileFilter
@BeanProperty(bound=false) public FileFilter getAcceptAllFileFilter()
返回AcceptAll
文件过滤器。 例如,在Microsoft Windows上,这将是所有文件(*。*)。- 结果
-
AcceptAll
文件过滤器
-
isAcceptAllFileFilterUsed
public boolean isAcceptAllFileFilterUsed()
返回是否使用AcceptAll FileFilter
。- 结果
-
如果使用
AcceptAll FileFilter
则为true - 从以下版本开始:
- 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
可用的文件过滤器列表中删除AcceptAll
文件过滤器。 如果为true,则AcceptAll
文件过滤器将成为主动使用的文件过滤器。- 参数
-
b
- aboolean
,其确定AcceptAll
文件过滤器是否是可选择过滤器列表中的可用选择 - 从以下版本开始:
- 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
。- 参数
-
mode
- 要显示的文件类型:- JFileChooser.FILES_ONLY
- JFileChooser.DIRECTORIES_ONLY
- JFileChooser.FILES_AND_DIRECTORIES
- 异常
-
IllegalArgumentException
- 如果mode
是非法文件选择模式 - 另请参见:
-
getFileSelectionMode()
-
getFileSelectionMode
public int getFileSelectionMode()
返回当前的文件选择模式。 默认值为JFilesChooser.FILES_ONLY
。- 结果
-
要显示的文件类型,请执行以下操作之一:
- JFileChooser.FILES_ONLY
- JFileChooser.DIRECTORIES_ONLY
- JFileChooser.FILES_AND_DIRECTORIES
- 另请参见:
-
setFileSelectionMode(int)
-
isFileSelectionEnabled
@BeanProperty(bound=false) public boolean isFileSelectionEnabled()
方便电话确定文件是否可以基于当前文件选择模式进行选择。- 结果
- 如果文件可选,则为true,否则为false
- 另请参见:
-
setFileSelectionMode(int)
,getFileSelectionMode()
-
isDirectorySelectionEnabled
@BeanProperty(bound=false) public boolean isDirectorySelectionEnabled()
方便电话确定目录是否可以根据当前的文件选择模式进行选择。- 结果
- 如果目录可选,则为true,否则为false
- 另请参见:
-
setFileSelectionMode(int)
,getFileSelectionMode()
-
setMultiSelectionEnabled
@BeanProperty(description="Sets multiple file selection mode.") public void setMultiSelectionEnabled(boolean b)
设置文件选择器以允许多个文件选择。- 参数
-
b
- 如果可以选择多个文件,b
true - 另请参见:
-
isMultiSelectionEnabled()
-
isMultiSelectionEnabled
public boolean isMultiSelectionEnabled()
如果可以选择多个文件,则返回true。- 结果
- 如果可以选择多个文件,则为true
- 另请参见:
-
setMultiSelectionEnabled(boolean)
-
isFileHidingEnabled
public boolean isFileHidingEnabled()
如果文件选择器中未显示隐藏文件,则返回true; 否则返回false。- 结果
- 文件隐藏属性的状态
- 另请参见:
-
setFileHidingEnabled(boolean)
-
setFileHidingEnabled
@BeanProperty(preferred=true, description="Sets file hiding on or off.") public void setFileHidingEnabled(boolean b)
设置文件隐藏打开或关闭。 如果为true,隐藏文件将不会显示在文件选择器中。 确定显示哪些文件的工作由FileView
完成。- 参数
-
b
- 确定文件隐藏打开的布尔值 - 另请参见:
-
isFileHidingEnabled()
-
setFileFilter
@BeanProperty(preferred=true, description="Sets the File Filter used to filter out files of type.") public void setFileFilter(FileFilter filter)
设置当前文件过滤器。 文件选择器使用文件过滤器从用户的视图过滤出文件。- 参数
-
filter
- 要使用的新的当前文件过滤器 - 另请参见:
-
getFileFilter()
-
getFileFilter
public FileFilter getFileFilter()
返回当前选择的文件过滤器。
-
setFileView
@BeanProperty(preferred=true, description="Sets the File View used to get file type information.") public void setFileView(FileView fileView)
设置用于检索UI信息的文件视图,例如表示文件的图标或文件的类型说明。- 参数
-
fileView
- 用于检索UI信息的FileView
- 另请参见:
-
getFileView()
-
getFileView
public FileView getFileView()
返回当前文件视图。- 结果
- 当前文件视图
- 另请参见:
-
setFileView(javax.swing.filechooser.FileView)
-
getName
public String getName(File f)
返回文件名。- 参数
-
f
-File
- 结果
-
该
String
包含的文件名f
- 另请参见:
-
FileView.getName(java.io.File)
-
getDescription
public String getDescription(File f)
返回文件描述。- 参数
-
f
-File
- 结果
-
该
String
包含为文件描述f
- 另请参见:
-
FileView.getDescription(java.io.File)
-
getTypeDescription
public String getTypeDescription(File f)
返回文件类型。- 参数
-
f
-File
- 结果
-
该
String
包含为文件类型描述f
- 另请参见:
-
FileView.getTypeDescription(java.io.File)
-
getIcon
public Icon getIcon(File f)
返回此文件或文件类型的图标,具体取决于系统。- 参数
-
f
-File
- 结果
-
该文件的
Icon
或文件类型 - 另请参见:
-
FileView.getIcon(java.io.File)
-
isTraversable
public boolean isTraversable(File f)
如果可以访问文件(目录),则返回true。 如果目录无法遍历,返回false。- 参数
-
f
-File
- 结果
- 如果文件/目录可以遍历,则为true,否则为false
- 另请参见:
-
FileView.isTraversable(java.io.File)
-
accept
public boolean accept(File f)
如果文件应该显示,则返回true。- 参数
-
f
-File
- 结果
- 如果文件应该显示为true,否则为false
- 另请参见:
-
FileFilter.accept(java.io.File)
-
setFileSystemView
@BeanProperty(expert=true, description="Sets the FileSytemView used to get filesystem information.") public void setFileSystemView(FileSystemView fsv)
设置JFileChooser
用于访问和创建文件系统资源的文件系统视图,例如查找软盘驱动器和获取根驱动器列表。- 参数
-
fsv
- 新的FileSystemView
- 另请参见:
-
FileSystemView
-
getFileSystemView
public FileSystemView getFileSystemView()
返回文件系统视图。- 结果
-
FileSystemView
对象 - 另请参见:
-
setFileSystemView(javax.swing.filechooser.FileSystemView)
-
approveSelection
public void approveSelection()
当用户点击“批准”按钮(默认情况下标记为“打开”或“保存”)时,由用户名称调用。 这也可以由程序员调用。 此方法使命令字符串触发一个动作事件等于APPROVE_SELECTION
。- 另请参见:
-
APPROVE_SELECTION
-
cancelSelection
public void cancelSelection()
当用户选择“取消”按钮时,由UI调用。 这也可以由程序员调用。 此方法使命令字符串触发的动作事件等于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
s或一个空数组,如果没有动作侦听器当前注册 - 从以下版本开始:
- 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()
获取实现此组件的L&F的UI对象。- 重写:
-
getUI
在JComponent
- 结果
- 实现FileChooserUI L&F的FileChooserUI对象
-
paramString
protected String paramString()
返回此JFileChooser
的字符串表示JFileChooser
。 该方法仅用于调试目的,并且返回的字符串的内容和格式可能因实现而异。 返回的字符串可能为空,但可能不是null
。- 重写:
-
paramString
在JComponent
- 结果
-
这是
JFileChooser
的字符串表示
-
getAccessibleContext
@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
获取与此JFileChooser关联的AccessibleContext。 对于文件选择器,AccessibleContext采用AccessibleJFileChooser的形式。 如有必要,将创建一个新的AccessibleJFileChooser实例。- Specified by:
-
getAccessibleContext
在接口Accessible
- 重写:
-
getAccessibleContext
在Component
- 结果
- 一个AccessibleJFileChooser,作为这个JFileChooser的AccessibleContext
-
-