モジュール java.desktop

パッケージ javax.swing

クラスJFileChooser

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JFileChooser

すべての実装されたインタフェース:

ImageObserver, MenuContainer, Serializable, Accessible

@JavaBean(defaultProperty="UI", description="A component which allows for the interactive selection of a file.") public class JFileChooser extends JComponent implements Accessible

JFileChooserは、ユーザーがファイルを選択するための単純なメカニズムを提供します。 JFileChooserの情報については、「The Java Tutorial」の「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

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラス	説明
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	このJFileChooserに関連付けられたAccessibleContext
static final String	ACCESSORY_CHANGED_PROPERTY	別のアクセサリ・コンポーネントが、たとえばファイルをプレビューするために使用されていることを示します。
static final String	APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY	応答(「yes」、「ok」)ボタンのニーモニックの変更を識別します。
static final String	APPROVE_BUTTON_TEXT_CHANGED_PROPERTY	応答(「yes」、「ok」)ボタンのテキストの変更を識別します。
static final String	APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY	応答(「yes」、「ok」)ボタンのツールヒント・テキストの変更を識別します。
static final int	APPROVE_OPTION	応答ボタン(「yes」、「ok」)が選択された場合の戻り値です。
static final String	APPROVE_SELECTION	現在の選択を承認する命令です。「yes」または「ok」を押す操作と同じ働きをします。
static final int	CANCEL_OPTION	「cancel」が選択された場合の戻り値です。
static final String	CANCEL_SELECTION	現在の選択を取り消す命令です。
static final String	CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY	ユーザーが選択できる定義済みファイル・フィルタ・リストの変更を識別します。
static final String	CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY	コントロール・ボタンを表示する命令です。
static final int	CUSTOM_DIALOG	開発者が指定したファイル操作をJFileChooserがサポートすることを示すダイアログ型の値です。
static final String	DIALOG_TITLE_CHANGED_PROPERTY	ダイアログのタイトルの変更を識別します。
static final String	DIALOG_TYPE_CHANGED_PROPERTY	表示されるファイルの種類(ファイルのみ、ディレクトリのみ、または両方)の変更を識別します。
static final int	DIRECTORIES_ONLY	ディレクトリだけを表示する命令です。
static final String	DIRECTORY_CHANGED_PROPERTY	ユーザーのディレクトリの変更を識別します。
static final int	ERROR_OPTION	エラーが発生した場合の戻り値です。
static final String	FILE_FILTER_CHANGED_PROPERTY	表示するファイルの種類をユーザーが変更したことを識別します。
static final String	FILE_HIDING_CHANGED_PROPERTY	隠しファイルの表示プロパティの変更を識別します。
static final String	FILE_SELECTION_MODE_CHANGED_PROPERTY	選択の種類(単一、複数など)の変更を識別します。
static final String	FILE_SYSTEM_VIEW_CHANGED_PROPERTY	システム上の利用可能ドライブを検索するために別のオブジェクトが使われていることを示します。
static final String	FILE_VIEW_CHANGED_PROPERTY	ファイル情報を取得するために別のオブジェクトが使われていることを示します。
static final int	FILES_AND_DIRECTORIES	ファイルとディレクトリの両方を表示する命令です。
static final int	FILES_ONLY	ファイルだけを表示する命令です。
static final String	MULTI_SELECTION_ENABLED_CHANGED_PROPERTY	複数ファイルの選択を有効にします。
static final int	OPEN_DIALOG	JFileChooserがファイルを開く操作をサポートすることを示すダイアログ型の値です。
static final int	SAVE_DIALOG	JFileChooserがファイル保存操作をサポートすることを示すダイアログ型の値です。
static final String	SELECTED_FILE_CHANGED_PROPERTY	ユーザーの単一ファイル選択の変更を識別します。
static final String	SELECTED_FILES_CHANGED_PROPERTY	ユーザーの複数ファイル選択の変更を識別します。

クラスjavax.swing.JComponentで宣言されたフィールド

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

クラスjava.awt.Componentで宣言されたフィールド

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

インタフェースjava.awt.image.ImageObserverで宣言されているフィールド

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
JFileChooser()	ユーザーのデフォルト・ディレクトリを参照するJFileChooserを構築します。
JFileChooser(File currentDirectory)	指定されたFileをパスとして使ってJFileChooserを構築します。
JFileChooser(File currentDirectory, FileSystemView fsv)	指定された現在のディレクトリとFileSystemViewを使ってJFileChooserを構築します。
JFileChooser(String currentDirectoryPath)	指定されたパスを使ってJFileChooserを構築します。
JFileChooser(String currentDirectoryPath, FileSystemView fsv)	指定された現在のディレクトリ・パスとFileSystemViewを使ってJFileChooserを構築します。
JFileChooser(FileSystemView fsv)	指定されたFileSystemViewを使ってJFileChooserを構築します。

メソッドのサマリー

修飾子と型	メソッド	説明
boolean	accept(File f)	ファイルを表示する必要がある場合にtrueを返します。
void	addActionListener(ActionListener l)	ファイル・チューザにActionListenerを追加します。
void	addChoosableFileFilter(FileFilter filter)	ユーザーが選択可能なファイル・フィルタのリストにフィルタを追加します。
void	approveSelection()	ユーザーが「Approve」ボタン(デフォルトでは「Open」または「Save」とラベル付けされている)をクリックしたときにUIによって呼び出されます。
void	cancelSelection()	ユーザーが「Cancel」ボタンをクリックしたときにUIによって呼び出されます。
void	changeToParentDirectory()	現在のディレクトリの親に設定されるディレクトリを変更します。
protected JDialog	createDialog(Component parent)	parentのフレーム内のparentの中央にthisをラップしている新しいJDialogを作成して返します。
void	ensureFileIsVisible(File f)	指定されたファイルが表示可能で、隠されないことを確認します。
protected void	fireActionPerformed(String command)	このイベント・タイプの通知対象として登録されているすべてのリスナーに通知します。
FileFilter	getAcceptAllFileFilter()	AcceptAllファイル・フィルタを返します。
AccessibleContext	getAccessibleContext()	このJFileChooserに関連したAccessibleContextを返します。
JComponent	getAccessory()	アクセサリ・コンポーネントを返します。
ActionListener[]	getActionListeners()	このファイル・チューザに登録されたすべてのアクション・リスナーの配列を返します。
int	getApproveButtonMnemonic()	「approve」ボタンのニーモニックを返します。
String	getApproveButtonText()	FileChooserUIのApproveButtonに使用されるテキストを返します。
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の文字列表現を返します。
void	removeActionListener(ActionListener l)	ファイル・チューザからActionListenerを削除します。
boolean	removeChoosableFileFilter(FileFilter f)	ユーザーが選択可能なファイル・フィルタのリストからフィルタを削除します。
void	rescanCurrentDirectory()	現在のディレクトリを再走査し、新しいファイルのリストを取得するようUIに指示します。
void	resetChoosableFileFilters()	選択可能なファイル・フィルタのリストを最初の状態にリセットします。
void	setAcceptAllFileFilterUsed(boolean b)	AcceptAll FileFilterを選択可能フィルタのリストで有効な選択肢として使用するかどうかを決定します。
void	setAccessory(JComponent newAccessory)	アクセサリ・コンポーネントを設定します。
void	setApproveButtonMnemonic(char mnemonic)	文字列を使って「approve」ボタンのニーモニックを設定します。
void	setApproveButtonMnemonic(int mnemonic)	数値キー・コードを使って「approve」ボタンのニーモニックを設定します。
void	setApproveButtonText(String approveButtonText)	FileChooserUIのApproveButtonで使用されるテキストを設定します。
void	setApproveButtonToolTipText(String toolTipText)	ApproveButtonで使用されるツールヒント・テキストを設定します。
void	setControlButtonsAreShown(boolean b)	approveボタンとcancelボタンをファイル・チューザに表示するかどうかを示すプロパティを設定します。
void	setCurrentDirectory(File dir)	現在のディレクトリを設定します。
void	setDialogTitle(String dialogTitle)	JFileChooserウィンドウのタイトル・バーに表示される文字列を設定します。
void	setDialogType(int dialogType)	このダイアログの種類を設定します。
void	setDragEnabled(boolean b)	dragEnabledプロパティを設定します。このプロパティは、このコンポーネントの自動ドラッグ処理(ドラッグ・アンド・ドロップの最初の処理)を有効にするためにtrueである必要があります。
void	setEnabled(boolean enabled)	このコンポーネントが有効であるかどうかを設定します。
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プロパティをリセットします。

クラス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, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

クラスjava.awt.Containerで宣言されたメソッド

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

クラスjava.awt.Componentで宣言されたメソッド

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

フィールド詳細

OPEN_DIALOG

public static final int OPEN_DIALOG

JFileChooserがファイルを開く操作をサポートすることを示すダイアログ型の値です。

関連項目:

• 定数フィールド値

SAVE_DIALOG

public static final int SAVE_DIALOG

JFileChooserがファイル保存操作をサポートすることを示すダイアログ型の値です。

関連項目:

• 定数フィールド値

CUSTOM_DIALOG

public static final int CUSTOM_DIALOG

開発者が指定したファイル操作をJFileChooserがサポートすることを示すダイアログ型の値です。

関連項目:

• 定数フィールド値

CANCEL_OPTION

public static final int CANCEL_OPTION

「cancel」が選択された場合の戻り値です。

関連項目:

• 定数フィールド値

APPROVE_OPTION

public static final int APPROVE_OPTION

応答ボタン(「yes」、「ok」)が選択された場合の戻り値です。

関連項目:

• 定数フィールド値

ERROR_OPTION

public static final int ERROR_OPTION

エラーが発生した場合の戻り値です。

関連項目:

• 定数フィールド値

FILES_ONLY

public static final int FILES_ONLY

ファイルだけを表示する命令です。

関連項目:

• 定数フィールド値

DIRECTORIES_ONLY

public static final int DIRECTORIES_ONLY

ディレクトリだけを表示する命令です。

関連項目:

• 定数フィールド値

FILES_AND_DIRECTORIES

public static final int FILES_AND_DIRECTORIES

ファイルとディレクトリの両方を表示する命令です。

関連項目:

• 定数フィールド値

CANCEL_SELECTION

public static final String CANCEL_SELECTION

現在の選択を取り消す命令です。

関連項目:

• 定数フィールド値

APPROVE_SELECTION

public static final String APPROVE_SELECTION

現在の選択を承認する命令です。「yes」または「ok」を押す操作と同じ働きをします。

関連項目:

• 定数フィールド値

APPROVE_BUTTON_TEXT_CHANGED_PROPERTY

public static final String APPROVE_BUTTON_TEXT_CHANGED_PROPERTY

応答(「yes」、「ok」)ボタンのテキストの変更を識別します。

関連項目:

• 定数フィールド値

APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY

public static final String APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY

応答(「yes」、「ok」)ボタンのツールヒント・テキストの変更を識別します。

関連項目:

• 定数フィールド値

APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY

public static final String APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY

応答(「yes」、「ok」)ボタンのニーモニックの変更を識別します。

関連項目:

• 定数フィールド値

CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY

public static final String CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY

コントロール・ボタンを表示する命令です。

関連項目:

• 定数フィールド値

DIRECTORY_CHANGED_PROPERTY

public static final String DIRECTORY_CHANGED_PROPERTY

ユーザーのディレクトリの変更を識別します。

関連項目:

• 定数フィールド値

SELECTED_FILE_CHANGED_PROPERTY

public static final String SELECTED_FILE_CHANGED_PROPERTY

ユーザーの単一ファイル選択の変更を識別します。

関連項目:

• 定数フィールド値

SELECTED_FILES_CHANGED_PROPERTY

public static final String SELECTED_FILES_CHANGED_PROPERTY

ユーザーの複数ファイル選択の変更を識別します。

関連項目:

• 定数フィールド値

MULTI_SELECTION_ENABLED_CHANGED_PROPERTY

public static final String MULTI_SELECTION_ENABLED_CHANGED_PROPERTY

複数ファイルの選択を有効にします。

関連項目:

• 定数フィールド値

FILE_SYSTEM_VIEW_CHANGED_PROPERTY

public static final String FILE_SYSTEM_VIEW_CHANGED_PROPERTY

システム上の利用可能ドライブを検索するために別のオブジェクトが使われていることを示します。

関連項目:

• 定数フィールド値

FILE_VIEW_CHANGED_PROPERTY

public static final String FILE_VIEW_CHANGED_PROPERTY

ファイル情報を取得するために別のオブジェクトが使われていることを示します。

関連項目:

• 定数フィールド値

FILE_HIDING_CHANGED_PROPERTY

public static final String FILE_HIDING_CHANGED_PROPERTY

隠しファイルの表示プロパティの変更を識別します。

関連項目:

• 定数フィールド値

FILE_FILTER_CHANGED_PROPERTY

public static final String FILE_FILTER_CHANGED_PROPERTY

表示するファイルの種類をユーザーが変更したことを識別します。

関連項目:

• 定数フィールド値

FILE_SELECTION_MODE_CHANGED_PROPERTY

public static final String FILE_SELECTION_MODE_CHANGED_PROPERTY

選択の種類(単一、複数など)の変更を識別します。

関連項目:

• 定数フィールド値

ACCESSORY_CHANGED_PROPERTY

public static final String ACCESSORY_CHANGED_PROPERTY

別のアクセサリ・コンポーネントが、たとえばファイルをプレビューするために使用されていることを示します。

関連項目:

• 定数フィールド値

ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY

public static final String ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY

AcceptAllFileFilterが使用されているかどうかを識別します。

関連項目:

• 定数フィールド値

DIALOG_TITLE_CHANGED_PROPERTY

public static final String DIALOG_TITLE_CHANGED_PROPERTY

ダイアログのタイトルの変更を識別します。

関連項目:

• 定数フィールド値

DIALOG_TYPE_CHANGED_PROPERTY

public static final String DIALOG_TYPE_CHANGED_PROPERTY

表示されるファイルの種類(ファイルのみ、ディレクトリのみ、または両方)の変更を識別します。

関連項目:

• 定数フィールド値

CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY

public static final String CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY

ユーザーが選択できる定義済みファイル・フィルタ・リストの変更を識別します。

関連項目:

• 定数フィールド値

accessibleContext

protected AccessibleContext accessibleContext

このJFileChooserに関連付けられたAccessibleContext

コンストラクタの詳細

JFileChooser

public JFileChooser()

ユーザーのデフォルト・ディレクトリを参照するJFileChooserを構築します。 このデフォルト・ディレクトリは、オペレーティング・システムによって異なります。 通常、これはWindows上の"マニュアル"フォルダであり、Unix上のユーザー・ホーム・ディレクトリです。

JFileChooser

public JFileChooser(String currentDirectoryPath)

指定されたパスを使ってJFileChooserを構築します。 null文字列が渡された場合、ファイル・チューザはユーザーのデフォルト・ディレクトリを参照します。 このデフォルト・ディレクトリは、オペレーティング・システムによって異なります。 通常、これはWindows上の"マニュアル"フォルダであり、Unix上のユーザー・ホーム・ディレクトリです。

パラメータ:

currentDirectoryPath - ファイルまたはディレクトリのパスを指定するString

JFileChooser

public JFileChooser(File currentDirectory)

指定されたFileをパスとして使ってJFileChooserを構築します。 nullファイルが渡された場合、ファイル・チューザはユーザーのデフォルト・ディレクトリを参照します。 このデフォルト・ディレクトリは、オペレーティング・システムによって異なります。 通常、これはWindows上の"マニュアル"フォルダであり、Unix上のユーザー・ホーム・ディレクトリです。

パラメータ:

currentDirectory - ファイルまたはディレクトリのパスを指定するFileオブジェクト

JFileChooser

public JFileChooser(FileSystemView fsv)

指定されたFileSystemViewを使ってJFileChooserを構築します。

パラメータ:

fsv - a FileSystemView

JFileChooser

public JFileChooser(File currentDirectory, FileSystemView fsv)

指定された現在のディレクトリとFileSystemViewを使ってJFileChooserを構築します。

パラメータ:

currentDirectory - ファイルまたはディレクトリのパスを指定するFileオブジェクト

fsv - a FileSystemView

JFileChooser

public JFileChooser(String currentDirectoryPath, FileSystemView fsv)

指定された現在のディレクトリ・パスとFileSystemViewを使ってJFileChooserを構築します。

パラメータ:

currentDirectoryPath - ファイルまたはディレクトリへのパスを指定するString

fsv - a FileSystemView

メソッドの詳細

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に設定すると、選択の動作に微妙に影響する場合があります。

ルック・アンド・フィールによっては、自動ドラッグ・アンド・ドロップ操作がサポートされていない場合があります。その場合、このプロパティは無視されます。 TransferHandlerのexportAsDragメソッドを直接呼び出すようにコンポーネントを変更することにより、このようなルック・アンド・フィールを操作できます。

パラメータ:

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の配列

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

現在のディレクトリを再走査し、新しいファイルのリストを取得するようUIに指示します。

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

カスタム承認ボタンとともにカスタム・ファイル・チューザを表示します。 たとえば、次のコードは、通常の「Save」または「Open」ボタンではなく「Run Application」ボタンの付いたファイル・チューザを表示します。

 filechooser.showDialog(parentFrame, "Run Application");
 

また、次のコードでも同じことができます。

    JFileChooser chooser = new JFileChooser(null);
    chooser.setApproveButtonText("Run Application");
    chooser.showDialog(parentFrame, null);
 

parent引数は、ファイルを開くダイアログが依存するフレーム、およびダイアログを配置するときにルック・アンド・フィールがその位置を考慮する必要があるコンポーネントを設定します。 親がJFrameなどのFrameオブジェクトの場合、ダイアログはフレームに依存しルック・アンド・フィールは、たとえばフレームの上の中央というようにフレームを基準にダイアログを配置します。 親がコンポーネントの場合は、ダイアログはコンポーネントを含むフレームに依存し、たとえばコンポーネントの上の中央というようにコンポーネントを基準に配置されます。 親が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

parentのフレーム内のparentの中央にthisをラップしている新しいJDialogを作成して返します。 このメソッドは、ダイアログをさらに操作したり、サイズ変更を無効にしたり、ロケーションを設定したりするためにオーバーライドできます。例:

     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)

approveボタンとcancelボタンをファイル・チューザに表示するかどうかを示すプロパティを設定します。 このプロパティはデフォルトでtrueです。 これらのボタンを常に表示するルック・アンド・フィールは、このプロパティの値を無視します。 このメソッドは、CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTYの文字列値をプロパティ名として使用し、プロパティ変更イベントをトリガーします。

パラメータ:

b - コントロール・ボタンを表示する場合はtrue、そうでない場合はfalse

導入されたバージョン:

1.3

関連項目:

• getControlButtonsAreShown()
• CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY

getDialogType

public int getDialogType()

このダイアログの種類を返します。 デフォルトはJFileChooser.OPEN_DIALOGです。

戻り値:

the type of dialog to be displayed:

• 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を使用します。 「Open」や「Save」ではなく、コンテキストのファイル・チューザを使用する場合は、CUSTOM_DIALOGを使用します。 たとえば、ファイル・チューザを呼び出して、ユーザーが実行するファイルを選択できるようにするとします。 この場合、通常はCUSTOM_DIALOGを使用するためにJFileChooserを設定する必要はありません。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()

「approve」ボタンのニーモニックを返します。

戻り値:

ニーモニック・キーを示す整数値

関連項目:

• setApproveButtonMnemonic(int)

setApproveButtonMnemonic

@BeanProperty(preferred=true, description="The mnemonic key accelerator for the ApproveButton.") public void setApproveButtonMnemonic(int mnemonic)

数値キー・コードを使って「approve」ボタンのニーモニックを設定します。

パラメータ:

mnemonic - ニーモニック・キーを示す整数値

関連項目:

• getApproveButtonMnemonic()

setApproveButtonMnemonic

public void setApproveButtonMnemonic(char mnemonic)

文字列を使って「approve」ボタンのニーモニックを設定します。

パラメータ:

mnemonic - ニーモニック・キーの文字列値

関連項目:

• getApproveButtonMnemonic()

setApproveButtonText

@BeanProperty(preferred=true, description="The text that goes in the ApproveButton.") public void setApproveButtonText(String approveButtonText)

FileChooserUIのApproveButtonで使用されるテキストを設定します。

パラメータ:

approveButtonText - ApproveButtonで使用されるテキスト

関連項目:

• getApproveButtonText()
• setDialogType(int)
• showDialog(java.awt.Component, java.lang.String)

getApproveButtonText

public String getApproveButtonText()

FileChooserUIのApproveButtonに使用されるテキストを返します。 nullの場合、UIオブジェクトがボタンのテキストを決めます。 通常は「Open」または「Save」です。

戻り値:

ApproveButtonで使用されるテキスト

関連項目:

• setApproveButtonText(java.lang.String)
• setDialogType(int)
• showDialog(java.awt.Component, java.lang.String)

getChoosableFileFilters

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

ユーザーが選択可能なファイル・フィルタのリストを返します。

戻り値:

選択可能なすべてのファイル・フィルタが格納されたFileFilter配列

関連項目:

• addChoosableFileFilter(javax.swing.filechooser.FileFilter)
• removeChoosableFileFilter(javax.swing.filechooser.FileFilter)
• resetChoosableFileFilters()

addChoosableFileFilter

@BeanProperty(preferred=true, description="Adds a filter to the list of user choosable file filters.") public void addChoosableFileFilter(FileFilter filter)

ユーザーが選択可能なファイル・フィルタのリストにフィルタを追加します。 ファイル選択モードの設定については、setFileSelectionModeを参照してください。

パラメータ:

filter - 選択可能なファイル・フィルタのリストに追加する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ファイル・フィルタを残して、追加されたすべてのファイル・フィルタが削除されます。

関連項目:

• addChoosableFileFilter(javax.swing.filechooser.FileFilter)
• getChoosableFileFilters()
• removeChoosableFileFilter(javax.swing.filechooser.FileFilter)

getAcceptAllFileFilter

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

AcceptAllファイル・フィルタを返します。 たとえば、Microsoft Windowsの場合はAll Files (*.*)になります。

戻り値:

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ファイル・フィルタは使用可能なファイル・フィルタのリストから削除されます。 trueの場合、AcceptAllファイル・フィルタがアクティブに使用されるファイル・フィルタになります。

パラメータ:

b - AcceptAllファイル・フィルタが選択可能フィルタ・リスト内で利用可能な選択肢であるかどうかを判定するboolean

導入されたバージョン:

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 - 複数のファイルを選択できる場合は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 - ファイルの非表示がオンかオフかを指定するboolean値

関連項目:

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

現在選択されているファイル・フィルタを返します。

戻り値:

現在のファイル・フィルタ

関連項目:

• setFileFilter(javax.swing.filechooser.FileFilter)
• addChoosableFileFilter(javax.swing.filechooser.FileFilter)

setFileView

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

ファイルを表すアイコンやファイルのタイプ説明など、UI情報の取得に使用するファイル・ビューを設定します。

パラメータ:

fileView - UI情報の取得に使用するFileView

関連項目:

• getFileView()

getFileView

public FileView getFileView()

現在のファイル・ビューを返します。

戻り値:

現在のファイル・ビュー

関連項目:

• setFileView(javax.swing.filechooser.FileView)

getName

public String getName(File f)

ファイル名を返します。

パラメータ:

f - File

戻り値:

fのファイル名を格納するString

関連項目:

• FileView.getName(java.io.File)

getDescription

public String getDescription(File f)

ファイルの説明を返します。

パラメータ:

f - File

戻り値:

fのファイルの説明を格納するString

関連項目:

• FileView.getDescription(java.io.File)

getTypeDescription

public String getTypeDescription(File f)

ファイル・タイプを返します。

パラメータ:

f - File

戻り値:

fのファイル型の説明を格納するString

関連項目:

• 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 FileSystemView 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」ボタン(デフォルトでは「Open」または「Save」とラベル付けされている)をクリックしたときにUIによって呼び出されます。 プログラマが呼び出すこともできます。 このメソッドはAPPROVE_SELECTIONに相当するコマンド文字列を使用してアクション・イベントをトリガーします。

関連項目:

• APPROVE_SELECTION

cancelSelection

public void cancelSelection()

ユーザーが「Cancel」ボタンをクリックしたときに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。アクション・リスナーが現在登録されていない場合は空の配列

導入されたバージョン:

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オブジェクトを取得します。

オーバーライド:

クラスJComponentのgetUI

戻り値:

FileChooserUI L&Fを実装するFileChooserUIオブジェクト

paramString

protected String paramString()

このJFileChooserの文字列表現を返します。 このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なる可能性があります。 返される文字列は空でもかまいませんが、nullにはできません。

オーバーライド:

paramString、クラスJComponent

戻り値:

このJFileChooserの文字列表現

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

このJFileChooserに関連したAccessibleContextを返します。 ファイル・チューザの場合、AccessibleContextはAccessibleJFileChooserの形式を取ります。 必要に応じて新規のAccessibleJFileChooserインスタンスが作成されます。

定義:

getAccessibleContext、インタフェースAccessible

オーバーライド:

getAccessibleContext、クラスComponent

戻り値:

このJFileChooserのAccessibleContextとして機能するAccessibleJFileChooser

setEnabled

public void setEnabled(boolean enabled)

このコンポーネントが有効であるかどうかを設定します。 有効なコンポーネントはユーザーの入力に反応できますが、無効なコンポーネントはユーザーの入力に反応できません。 コンポーネントによっては、自身が無効な場合に表示を変更して、入力を受け取れないことを示すフィード・バックをユーザーに提供できます。

ノート: コンポーネントを無効化しても子は無効化されません。

ノート: 軽量化コンポーネントを無効化してもMouseEventは受信されます。

オーバーライド:

setEnabled、クラスJComponent

パラメータ:

enabled - このコンポーネントを有効化する場合はtrue、そうでない場合はfalse

関連項目:

• Component.isEnabled()
• Component.isLightweight()