javax.swing
クラス JFileChooser

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.JFileChooser

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

Accessible, ImageObserver, MenuContainer, Serializable

public class JFileChooser

extends JComponent

implements Accessible

JFileChooser はユーザがファイルを選択する単純な機構を提供します。JFileChooser の情報については、「The Java Tutorial」の「How to Use File Choosers」を参照してください。

次のコードは、ユーザのホームディレクトリで、.jpg と .gif イメージのみを表示するファイルチューザを表示します。

    JFileChooser chooser = new JFileChooser();
    // Note: source for ExampleFileFilter can be found in FileChooserDemo,
    // under the demo/jfc directory in the Java 2 SDK, Standard Edition.
    ExampleFileFilter filter = new ExampleFileFilter();
    filter.addExtension("jpg");
    filter.addExtension("gif");
    filter.setDescription("JPG & GIF Images");
    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());
    }

関連項目:

直列化された形式

内部クラスの概要

protected class

JFileChooser.AccessibleJFileChooser このクラスは JFileChooser クラス用のユーザ補助機能のサポートを実装しています。

クラス javax.swing.JComponent から継承した内部クラス

JComponent.AccessibleJComponent

クラス java.awt.Container から継承した内部クラス

Container.AccessibleAWTContainer

クラス java.awt.Component から継承した内部クラス

Component.AccessibleAWTComponent

フィールドの概要

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

JFileChooser(String currentDirectoryPath)
指定されたパスを使って JFileChooser を構築します。

JFileChooser(String currentDirectoryPath, 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() 現在のディレクトリの親に設定されるディレクトリを変更します。
void	ensureFileIsVisible(File f) 指定されたファイルが表示可能であり、かつ隠されないこと保証します。
protected void	fireActionPerformed(String command) このイベントタイプへの通知を配信対象に登録しているリスナーをすべて通知します。
FileFilter	getAcceptAllFileFilter() AcceptAll ファイルフィルタを返します。
AccessibleContext	getAccessibleContext() この JFileChooser に関連した AccessibleContext を返します。
JComponent	getAccessory() アクセサリコンポーネントを返します。
int	getApproveButtonMnemonic() ApproveButton のニーモニックを返します。
String	getApproveButtonText() FileChooserUI で ApproveButton に使用されるテキストを返します。
String	getApproveButtonToolTipText() ApproveButton で使用されるツールヒントテキストを返します。
FileFilter[]	getChoosableFileFilters() ユーザが選択可能なファイルフィルタのリストを返します。
boolean	getControlButtonsAreShown() ファイルチューザに [accept] ボタンと [cancel] ボタンが表示されているかどうかを示す boolean を返します。
File	getCurrentDirectory() 現在のディレクトリを返します。
String	getDescription(File f) ファイルの説明を返します。
String	getDialogTitle() JFileChooser のタイトルバーに表示される文字列を返します。
int	getDialogType() このダイアログの種類を返します。
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) 文字を使って ApproveButton のニーモニックを設定します。
void	setApproveButtonMnemonic(int mnemonic) 数値キーコードを使って ApproveButton のニーモニックを設定します。
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	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) [Open File] ファイルチューザダイアログを表示します。
int	showSaveDialog(Component parent) [Save File] ファイルチューザダイアログを表示します。
void	updateUI() L&F が変更されたことを示す、UIFactory からの通知です。

クラス javax.swing.JComponent から継承したメソッド

addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getVerifyInputWhenFocusTarget, getVisibleRect, getWidth, getX, getY, grabFocus, hasFocus, hide, isDoubleBuffered, isFocusCycleRoot, isFocusTraversable, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processFocusEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDoubleBuffered, setEnabled, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

クラス java.awt.Container から継承したメソッド

add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getLayout, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree

クラス java.awt.Component から継承したメソッド

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, imageUpdate, inside, isDisplayable, isEnabled, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus

クラス 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

public JFileChooser()

ユーザのホームディレクトリを指す JFileChooser を構築します。

JFileChooser

public JFileChooser(String currentDirectoryPath)

指定されたパスを使って JFileChooser を構築します。null 文字列を渡すと、ファイルチューザはユーザのホームディレクトリを指します。

パラメータ:

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

JFileChooser

public JFileChooser(File currentDirectory)

指定された File をパスとして使って JFileChooser を構築します。null ファイルを渡すと、ファイルチューザはユーザのホームディレクトリを指します。

パラメータ:

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

JFileChooser

public JFileChooser(FileSystemView fsv)

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

JFileChooser

public JFileChooser(File currentDirectory,
                    FileSystemView fsv)

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

JFileChooser

public JFileChooser(String currentDirectoryPath,
                    FileSystemView fsv)

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

メソッドの詳細

setup

protected void setup(FileSystemView view)

コンストラクタに共通の初期化およびセットアップ処理を実行します。

getSelectedFile

public File getSelectedFile()

選択されたファイルを返します。ファイルは、プログラマによって setFile を通じて、または、UI へのファイル名の入力や、UI リストでのファイル選択などのユーザアクションによって設定できます。

戻り値:

選択されたファイル

関連項目:

setSelectedFile(java.io.File)

setSelectedFile

public void setSelectedFile(File file)

選択されたファイルを設定します。ファイルの親ディレクトリが現在のディレクトリでない場合は、現在のディレクトリがファイルの親ディレクトリに変更されます。

パラメータ:

file - 選択されたファイル

関連項目:

getSelectedFile()

getSelectedFiles

public File[] getSelectedFiles()

複数選択が許可されるようにファイルチューザが設定されている場合に、選択されたファイルのリストを返します。

setSelectedFiles

public void setSelectedFiles(File[] selectedFiles)

複数選択が許可されるようにファイルチューザが設定されている場合に、選択されたファイルのリストを設定します。

getCurrentDirectory

public File getCurrentDirectory()

現在のディレクトリを返します。

戻り値:

現在のディレクトリ

関連項目:

setCurrentDirectory(java.io.File)

setCurrentDirectory

public void setCurrentDirectory(File dir)

現在のディレクトリを設定します。null を渡すと、ユーザのホームディレクトリを指すようにファイルチューザが設定されます。 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)

[Open File] ファイルチューザダイアログを表示します。 ApproveButton に表示されるテキストは L&F によって決められることに注意してください。

パラメータ:

parent - ダイアログの親のコンポーネント。null も可。詳細は、showDialog を参照

戻り値:

ポップダウン時に返されるファイルチューザの状態。

• JFileChooser.CANCEL_OPTION
• JFileChooser.APPROVE_OPTION
• エラーが発生した場合、またはダイアログが取り消された場合は、JFileCHooser.ERROR_OPTION

関連項目:

showDialog(java.awt.Component, java.lang.String)

showSaveDialog

public int showSaveDialog(Component parent)

[Save File] ファイルチューザダイアログを表示します。ApproveButton に表示されるテキストは L&F によって決められることに注意してください。

パラメータ:

parent - ダイアログの親のコンポーネント。null も可。詳細は、showDialog を参照

戻り値:

ポップダウン時に返されるファイルチューザの状態。

• JFileChooser.CANCEL_OPTION
• JFileChooser.APPROVE_OPTION
• エラーが発生した場合、またはダイアログが取り消された場合は、JFileCHooser.ERROR_OPTION

関連項目:

showDialog(java.awt.Component, java.lang.String)

showDialog

public int showDialog(Component parent,
                      String approveButtonText)

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

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

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

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

parent 引数は、ファイルを開くダイアログが依存するフレーム、およびダイアログを配置するときに Look & Feel がその位置を考慮する必要があるコンポーネントを設定します。親が JFrame などの Frame オブジェクトの場合、ダイアログはフレームに依存し Look & Feel は、たとえばフレームの上の中央というようにフレームを基準にダイアログを配置します。親がコンポーネントの場合は、ダイアログはコンポーネントを含むフレームに依存し、たとえばコンポーネントの上の中央というようにコンポーネントを基準に配置されます。親が null の場合は、ダイアログは不可視状態のウィンドウに依存し、画面の中央のように Look & Feel 依存の位置に配置されます。

パラメータ:

parent - ダイアログの親のコンポーネント。null も可

approveButtonText - ApproveButton のテキスト

戻り値:

ポップダウン時に返されるファイルチューザの状態。

• JFileChooser.CANCEL_OPTION
• JFileChooser.APPROVE_OPTION
• エラーが発生した場合、またはダイアログが取り消された場合は、JFileCHooser.ERROR_OPTION

getControlButtonsAreShown

public boolean getControlButtonsAreShown()

ファイルチューザに [accept] ボタンと [cancel] ボタンが表示されているかどうかを示す boolean を返します。

戻り値:

[accept] ボタンと [cancel] ボタンが表示されている場合は true、そうでない場合は false

導入されたバージョン:

1.3

関連項目:

setControlButtonsAreShown(boolean)

setControlButtonsAreShown

public void setControlButtonsAreShown(boolean b)

ファイルチューザに [approve] ボタンと [cancel] ボタンを表示するかどうかを設定します。

導入されたバージョン:

1.3

関連項目:

getControlButtonsAreShown()

getDialogType

public int getDialogType()

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

戻り値:

表示されるダイアログの種類

• JFileChooser.OPEN_DIALOG
• JFileChooser.SAVE_DIALOG
• JFileChooser.CUSTOM_DIALOG

関連項目:

setDialogType(int)

setDialogType

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

public void setDialogTitle(String dialogTitle)

JFileChooser ウィンドウのタイトルバーに表示される文字列を設定します。

パラメータ:

dialogTitle - タイトルバーの新しい String

関連項目:

getDialogTitle()

getDialogTitle

public String getDialogTitle()

JFileChooser のタイトルバーに表示される文字列を返します。

関連項目:

setDialogTitle(java.lang.String)

setApproveButtonToolTipText

public void setApproveButtonToolTipText(String toolTipText)

ApproveButton で使用されるツールヒントテキストを設定します。null の場合、UI オブジェクトがボタンのテキストを決めます。

戻り値:

ApproveButton で使用されるテキスト

関連項目:

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

getApproveButtonToolTipText

public String getApproveButtonToolTipText()

ApproveButton で使用されるツールヒントテキストを返します。null の場合、UI オブジェクトがボタンのテキストを決めます。

戻り値:

ApproveButton で使用されるテキスト

関連項目:

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

getApproveButtonMnemonic

public int getApproveButtonMnemonic()

ApproveButton のニーモニックを返します。

戻り値:

ニーモニックキーを示す int 値

関連項目:

setApproveButtonMnemonic(int)

setApproveButtonMnemonic

public void setApproveButtonMnemonic(int mnemonic)

数値キーコードを使って ApproveButton のニーモニックを設定します。

パラメータ:

mnemonic - ニーモニックキーを示す int 値

関連項目:

getApproveButtonMnemonic()

setApproveButtonMnemonic

public void setApproveButtonMnemonic(char mnemonic)

文字を使って ApproveButton のニーモニックを設定します。

パラメータ:

mnemonic - ニーモニックキーの char 値

関連項目:

getApproveButtonMnemonic()

setApproveButtonText

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

public FileFilter[] getChoosableFileFilters()

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

戻り値:

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

関連項目:

addChoosableFileFilter(javax.swing.filechooser.FileFilter), removeChoosableFileFilter(javax.swing.filechooser.FileFilter), #resetChoosableFileFilter

addChoosableFileFilter

public void addChoosableFileFilter(FileFilter filter)

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

パラメータ:

filter - 選択可能なファイルフィルタのリストに追加する FileFilter

関連項目:

getChoosableFileFilters(), removeChoosableFileFilter(javax.swing.filechooser.FileFilter), #resetChoosableFileFilter

removeChoosableFileFilter

public boolean removeChoosableFileFilter(FileFilter f)

ユーザが選択可能なファイルフィルタのリストからフィルタを削除します。ファイルフィルタが削除された場合は true を返します。

関連項目:

addChoosableFileFilter(javax.swing.filechooser.FileFilter), getChoosableFileFilters(), #resetChoosableFileFilter

resetChoosableFileFilters

public void resetChoosableFileFilters()

選択可能なファイルフィルタのリストを最初の状態にリセットします。通常は、AcceptAll ファイルフィルタを残して、追加されたすべてのファイルフィルタが削除されます。

関連項目:

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

getAcceptAllFileFilter

public FileFilter getAcceptAllFileFilter()

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

isAcceptAllFileFilterUsed

public boolean isAcceptAllFileFilterUsed()

AcceptAll FileFilter が使用されるかどうかを返します。

戻り値:

AcceptAll FileFilter が使用される場合は true

導入されたバージョン:

1.3

関連項目:

setAcceptAllFileFilterUsed(boolean)

setAcceptAllFileFilterUsed

public void setAcceptAllFileFilterUsed(boolean b)

AcceptAll FileFilter が使用されるかどうかを判定します。

導入されたバージョン:

1.3

関連項目:

isAcceptAllFileFilterUsed()

getAccessory

public JComponent getAccessory()

アクセサリコンポーネントを返します。

戻り値:

この JFileChooser のアクセサリコンポーネント、または null

関連項目:

setAccessory(javax.swing.JComponent)

setAccessory

public void setAccessory(JComponent newAccessory)

アクセサリコンポーネントを設定します。アクセサリは、選択されたファイルのプレビューイメージを表示するのによく使われます。また、アクセサリは、特別なカスタムファイルチューザコントロールの作成など、さまざまな用途に利用できます。

注: 以前にアクセサリがあった場合は、アクセサリがファイルチューザに登録していた可能性があるすべてのリスナーを登録解除する必要があります。

setFileSelectionMode

public void setFileSelectionMode(int mode)

JFileChooser を設定して、ユーザが、ファイルのみ、ディレクトリのみ、またはファイルとディレクトリの両方を選択できるようにします。デフォルトは JFilesChooser.FILES_ONLY です。

パラメータ:

mode - 表示されるダイアログの種類

• JFileChooser.FILES_ONLY
• JFileChooser.DIRECTORIES_ONLY
• JFileChooser.FILES_AND_DIRECTORI ES

例外:

IllegalArgumentException - ダイアログの mode が無効な場合

関連項目:

getFileSelectionMode()

getFileSelectionMode

public int getFileSelectionMode()

現在のファイル選択モードを返します。デフォルトは JFilesChooser.FILES_ONLY です。

戻り値:

表示されるファイルの種類。次のうちのどれか。

• JFileChooser.FILES_ONLY
• JFileChooser.DIRECTORIES_ONLY
• JFileChooser.FILES_AND_DIRECTORIES

関連項目:

setFileSelectionMode(int)

isFileSelectionEnabled

public boolean isFileSelectionEnabled()

現在のファイル選択モードに基づいてファイルが選択可能かどうかを指定する簡易呼び出しです。

関連項目:

setFileSelectionMode(int), getFileSelectionMode()

isDirectorySelectionEnabled

public boolean isDirectorySelectionEnabled()

現在のファイル選択モードに基づいてディレクトリが選択可能かどうかを指定する簡易呼び出しです。

関連項目:

setFileSelectionMode(int), getFileSelectionMode()

setMultiSelectionEnabled

public void setMultiSelectionEnabled(boolean b)

ファイルチューザを設定して複数ファイル選択を可能にします。

注: この機能は現在の Look & Feel にはまだ実装されていません。

関連項目:

isMultiSelectionEnabled()

isMultiSelectionEnabled

public boolean isMultiSelectionEnabled()

複数のファイルを選択できる場合に true を返します。

戻り値:

複数のファイルを選択できる場合は true

関連項目:

setMultiSelectionEnabled(boolean)

isFileHidingEnabled

public boolean isFileHidingEnabled()

ファイルチューザで隠しファイルが表示されない場合は true を返し、そうでない場合は false を返します。

戻り値:

ファイルの非表示プロパティの状態

関連項目:

setFileHidingEnabled(boolean)

setFileHidingEnabled

public void setFileHidingEnabled(boolean b)

ファイルの非表示のオン、オフを設定します。true の場合、ファイルチューザで隠しファイルは表示されません。どのファイルが表示されるかを決める処理は FileView によって行われます。

パラメータ:

b - ファイルの非表示がオンかオフかを指定する boolean 値

関連項目:

isFileHidingEnabled()

setFileFilter

public void setFileFilter(FileFilter filter)

現在のファイルフィルタを設定します。ファイルフィルタは、ユーザに表示するファイルを選別するためにファイルチューザによって使用されます。

パラメータ:

filter - 使用する新しい現在のファイルフィルタ

関連項目:

getFileFilter()

getFileFilter

public FileFilter getFileFilter()

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

戻り値:

現在のファイルフィルタ

関連項目:

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

setFileView

public void setFileView(FileView fileView)

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

関連項目:

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

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 によって呼び出されます。プログラマが呼び出すこともできます。

cancelSelection

public void cancelSelection()

ユーザが [Cancel] ボタンをクリックしたときに UI によって呼び出されます。プログラマが呼び出すこともできます。

addActionListener

public void addActionListener(ActionListener l)

ボタンに ActionListener を追加します。

パラメータ:

l - 追加されるリスナー

removeActionListener

public void removeActionListener(ActionListener l)

ボタンから ActionListener を削除します。

パラメータ:

l - 削除されるリスナー

fireActionPerformed

protected void fireActionPerformed(String command)

このイベントタイプへの通知を配信対象に登録しているリスナーをすべて通知します。fire メソッドに渡されたパラメータを使用して、イベントのインスタンスはゆっくりと生成されます。

関連項目:

EventListenerList

updateUI

public void updateUI()

L&F が変更されたことを示す、UIFactory からの通知です。

オーバーライド:

クラス JComponent 内の updateUI

関連項目:

JComponent.updateUI()

getUIClassID

public String getUIClassID()

このコンポーネントを描画する L&F クラスの名前を文字列で返します。

オーバーライド:

クラス JComponent 内の getUIClassID

戻り値:

文字列「FileChooserUI」

関連項目:

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

getUI

public FileChooserUI getUI()

コンポーネントの L&F を実装する UI オブジェクトを返します。

戻り値:

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

paramString

protected String paramString()

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

オーバーライド:

クラス JComponent 内の paramString

戻り値:

この JFileChooser の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス JComponent 内の getAccessibleContext

戻り値:

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