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」を参照してください。
| 修飾子と型 | クラスと説明 |
|---|---|
protected class |
JFileChooser.AccessibleJFileChooser
このクラスは
JFileChooser クラスのアクセシビリティーサポートを実装しています。 |
JComponent.AccessibleJComponentContainer.AccessibleAWTContainerComponent.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy| 修飾子と型 | フィールドと説明 |
|---|---|
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
現在の選択を承認する命令です。[yes] または [ok] を押す操作と同じ働きをします。
|
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
ユーザーの複数ファイル選択の変更を識別します。
|
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOWBOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTABORT, 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()
現在のディレクトリの親に設定されるディレクトリを変更します。
|
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 |
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()
現在の Look & Feel からの値に UI プロパティーをリセットします。
|
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, updateadd, 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, validateTreeaction, 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, getPeer, 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, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCyclepublic static final int OPEN_DIALOG
JFileChooser がファイルを開く操作をサポートすることを示すダイアログ型の値です。public static final int SAVE_DIALOG
JFileChooser がファイル保存操作をサポートすることを示すダイアログ型の値です。public static final int CUSTOM_DIALOG
JFileChooser がサポートすることを示すダイアログ型の値です。public static final int CANCEL_OPTION
public static final int APPROVE_OPTION
public static final int ERROR_OPTION
public static final int FILES_ONLY
public static final int DIRECTORIES_ONLY
public static final int FILES_AND_DIRECTORIES
public static final String APPROVE_SELECTION
public static final String APPROVE_BUTTON_TEXT_CHANGED_PROPERTY
public static final String APPROVE_BUTTON_TOOL_TIP_TEXT_CHANGED_PROPERTY
public static final String APPROVE_BUTTON_MNEMONIC_CHANGED_PROPERTY
public static final String CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY
public static final String DIRECTORY_CHANGED_PROPERTY
public static final String SELECTED_FILE_CHANGED_PROPERTY
public static final String SELECTED_FILES_CHANGED_PROPERTY
public static final String MULTI_SELECTION_ENABLED_CHANGED_PROPERTY
public static final String FILE_SYSTEM_VIEW_CHANGED_PROPERTY
public static final String FILE_VIEW_CHANGED_PROPERTY
public static final String FILE_HIDING_CHANGED_PROPERTY
public static final String FILE_FILTER_CHANGED_PROPERTY
public static final String FILE_SELECTION_MODE_CHANGED_PROPERTY
public static final String ACCESSORY_CHANGED_PROPERTY
public static final String ACCEPT_ALL_FILE_FILTER_USED_CHANGED_PROPERTY
public static final String DIALOG_TITLE_CHANGED_PROPERTY
public static final String DIALOG_TYPE_CHANGED_PROPERTY
public static final String CHOOSABLE_FILE_FILTER_CHANGED_PROPERTY
protected AccessibleContext accessibleContext
public JFileChooser()
JFileChooser を構築します。このデフォルトディレクトリは、オペレーティングシステムによって異なります。通常、Windows では「My Documents」フォルダ、UNIX ではユーザーのホームディレクトリです。public JFileChooser(String currentDirectoryPath)
JFileChooser を構築します。null 文字列が渡された場合、ファイルチューザはユーザーのデフォルトディレクトリを参照します。このデフォルトディレクトリは、オペレーティングシステムによって異なります。通常、Windows では「My Documents」フォルダ、UNIX ではユーザーのホームディレクトリです。currentDirectoryPath - ファイルまたはディレクトリのパスを指定する Stringpublic JFileChooser(File currentDirectory)
File をパスとして使って JFileChooser を構築します。null ファイルが渡された場合、ファイルチューザはユーザーのデフォルトディレクトリを参照します。このデフォルトディレクトリは、オペレーティングシステムによって異なります。通常、Windows では「My Documents」フォルダ、UNIX ではユーザーのホームディレクトリです。currentDirectory - ファイルまたはディレクトリのパスを指定する File オブジェクトpublic JFileChooser(FileSystemView fsv)
FileSystemView を使って JFileChooser を構築します。public JFileChooser(File currentDirectory, FileSystemView fsv)
FileSystemView を使って JFileChooser を構築します。public JFileChooser(String currentDirectoryPath, FileSystemView fsv)
FileSystemView を使って JFileChooser を構築します。protected void setup(FileSystemView view)
public void setDragEnabled(boolean b)
dragEnabled プロパティーを設定します。このプロパティーは、このコンポーネントの自動ドラッグ処理 (ドラッグ&ドロップの最初の処理) を有効にするために true である必要があります。transferHandler プロパティーは、ドラッグでなんでもできるように null 以外の値に設定する必要があります。dragEnabled プロパティーのデフォルト値は false です。
自動ドラッグ処理が有効の場合、ほとんどの Look & Feel は、ユーザーが項目の上でマウスボタンを押して、マウスを数ピクセル移動すると常にドラッグ&ドロップ操作が始まります。したがって、このプロパティーを true に設定すると、選択の動作に微妙に影響する場合があります。
一部の Look & Feel は自動ドラッグ&ドロップ操作をサポートしない場合があります。これらはこのプロパティーを無視します。直接 TransferHandler の exportAsDrag メソッドを呼び出してコンポーネントを変更することにより、このような Look & Feel を操作できます。
b - dragEnabled プロパティーに設定される値HeadlessException - b が true で、GraphicsEnvironment.isHeadless() が true を返す場合GraphicsEnvironment.isHeadless(), getDragEnabled(), JComponent.setTransferHandler(javax.swing.TransferHandler), TransferHandlerpublic boolean getDragEnabled()
dragEnabled プロパティーの値を取得します。dragEnabled プロパティーの値setDragEnabled(boolean)public File getSelectedFile()
setSelectedFile を通じて、または、UI へのファイル名の入力や、UI リストでのファイル選択などのユーザーアクションによって設定できます。setSelectedFile(java.io.File)public void setSelectedFile(File file)
file - 選択されたファイルgetSelectedFile()public File[] getSelectedFiles()
public void setSelectedFiles(File[] selectedFiles)
public File getCurrentDirectory()
setCurrentDirectory(java.io.File)public void setCurrentDirectory(File dir)
null を渡すと、ファイルチューザがユーザーのデフォルトディレクトリを参照するように設定されます。このデフォルトディレクトリは、オペレーティングシステムによって異なります。通常、Windows では「My Documents」フォルダ、UNIX ではユーザーのホームディレクトリです。
currentDirectory として渡されたファイルがディレクトリでない場合、そのファイルの親が currentDirectory として使われます。親が探索可能でない場合は、探索可能なディレクトリが見つかるまで、またはファイルシステムのルートにたどりつくまで、親のツリーをルートに向かってたどります。dir - 現在のディレクトリgetCurrentDirectory()public void changeToParentDirectory()
public void rescanCurrentDirectory()
public void ensureFileIsVisible(File f)
f - File オブジェクトpublic int showOpenDialog(Component parent) throws HeadlessException
parent - ダイアログの親のコンポーネント。null も可。詳細は showDialog を参照HeadlessException - GraphicsEnvironment.isHeadless() が true を返した場合。GraphicsEnvironment.isHeadless(), showDialog(java.awt.Component, java.lang.String)public int showSaveDialog(Component parent) throws HeadlessException
parent - ダイアログの親のコンポーネント。null も可。詳細は showDialog を参照HeadlessException - GraphicsEnvironment.isHeadless() が true を返した場合。GraphicsEnvironment.isHeadless(), showDialog(java.awt.Component, java.lang.String)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 引数は、ファイルを開くダイアログが依存するフレーム、およびダイアログを配置するときに Look & Feel がその位置を考慮する必要があるコンポーネントを設定します。親が JFrame などの Frame オブジェクトの場合、ダイアログはフレームに依存し Look & Feel は、たとえばフレームの上の中央というようにフレームを基準にダイアログを配置します。親がコンポーネントの場合は、ダイアログはコンポーネントを含むフレームに依存し、たとえばコンポーネントの上の中央というようにコンポーネントを基準に配置されます。親が null の場合は、ダイアログは不可視状態のウィンドウに依存し、画面の中央のように Look & Feel 依存の位置に配置されます。
parent - ダイアログの親のコンポーネント。null も可approveButtonText - ApproveButton のテキストHeadlessException - GraphicsEnvironment.isHeadless() が true を返した場合。GraphicsEnvironment.isHeadless()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 も可JDialogHeadlessException - GraphicsEnvironment.isHeadless() が true を返した場合。GraphicsEnvironment.isHeadless()public boolean getControlButtonsAreShown()
controlButtonsAreShown プロパティーの値を返します。controlButtonsAreShown プロパティーの値setControlButtonsAreShown(boolean)public void setControlButtonsAreShown(boolean b)
true です。これらのボタンを常に表示する Look & Feel は、このプロパティーの値を無視します。このメソッドは、CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTY の文字列値をプロパティー名として使用し、プロパティー変更イベントをトリガーします。b - コントロールボタンを表示する場合は true、そうでない場合は falsegetControlButtonsAreShown(), CONTROL_BUTTONS_ARE_SHOWN_CHANGED_PROPERTYpublic int getDialogType()
JFileChooser.OPEN_DIALOG です。setDialogType(int)public void setDialogType(int dialogType)
OPEN_DIALOG を使用します。同様に、保存するファイルを選択できるようにするには SAVE_DIALOG を使用します。[Open] や [Save] ではなくコンテキストのファイルチューザを使用する場合は、CUSTOM_DIALOG を使用します。たとえば、ファイルチューザを呼び出して実行するファイルを選択するとします。この場合、通常は CUSTOM_DIALOG を使用するために JFileChooser を設定する必要はありません。setApproveButtonText を呼び出すとその処理を代わりに実行してくれるからです。デフォルトのダイアログの種類は JFileChooser.OPEN_DIALOG です。dialogType - 表示されるダイアログの種類。
IllegalArgumentException - dialogType が不正の場合getDialogType(), setApproveButtonText(java.lang.String)public void setDialogTitle(String dialogTitle)
JFileChooser ウィンドウのタイトルバーに表示される文字列を設定します。dialogTitle - タイトルバーの新しい StringgetDialogTitle()public String getDialogTitle()
JFileChooser のタイトルバーに表示される文字列を返します。public void setApproveButtonToolTipText(String toolTipText)
ApproveButton で使用されるツールヒントテキストを設定します。null の場合、UI オブジェクトがボタンのテキストを決めます。toolTipText - ApproveButton のツールヒントテキストsetApproveButtonText(java.lang.String), setDialogType(int), showDialog(java.awt.Component, java.lang.String)public String getApproveButtonToolTipText()
ApproveButton で使用されるツールヒントテキストを返します。null の場合、UI オブジェクトがボタンのテキストを決めます。setApproveButtonText(java.lang.String), setDialogType(int), showDialog(java.awt.Component, java.lang.String)public int getApproveButtonMnemonic()
setApproveButtonMnemonic(int)public void setApproveButtonMnemonic(int mnemonic)
mnemonic - ニーモニックキーを示す整数値getApproveButtonMnemonic()public void setApproveButtonMnemonic(char mnemonic)
mnemonic - ニーモニックキーの文字列値getApproveButtonMnemonic()public void setApproveButtonText(String approveButtonText)
FileChooserUI の ApproveButton で使用されるテキストを設定します。approveButtonText - ApproveButton で使用されるテキストgetApproveButtonText(), setDialogType(int), showDialog(java.awt.Component, java.lang.String)public String getApproveButtonText()
FileChooserUI の ApproveButton に使用されるテキストを返します。null の場合、UI オブジェクトがボタンのテキストを決めます。
通常は [Open] または [Save] です。ApproveButton で使用されるテキストsetApproveButtonText(java.lang.String), setDialogType(int), showDialog(java.awt.Component, java.lang.String)public FileFilter[] getChoosableFileFilters()
FileFilter 配列addChoosableFileFilter(javax.swing.filechooser.FileFilter), removeChoosableFileFilter(javax.swing.filechooser.FileFilter), resetChoosableFileFilters()public void addChoosableFileFilter(FileFilter filter)
setFileSelectionMode を参照してください。filter - 選択可能なファイルフィルタのリストに追加する FileFiltergetChoosableFileFilters(), removeChoosableFileFilter(javax.swing.filechooser.FileFilter), resetChoosableFileFilters(), setFileSelectionMode(int)public boolean removeChoosableFileFilter(FileFilter f)
public void resetChoosableFileFilters()
AcceptAll ファイルフィルタを残して、追加されたすべてのファイルフィルタが削除されます。public FileFilter getAcceptAllFileFilter()
AcceptAll ファイルフィルタを返します。たとえば、Microsoft Windows の場合は All Files (*.*) になります。public boolean isAcceptAllFileFilterUsed()
AcceptAll FileFilter が使用されているかどうかを返します。AcceptAll FileFilter が使用される場合は truesetAcceptAllFileFilterUsed(boolean)public void setAcceptAllFileFilterUsed(boolean b)
AcceptAll FileFilter を選択可能フィルタのリストで有効な選択肢として使用するかどうかを決定します。false の場合、AcceptAll ファイルフィルタは使用可能なファイルフィルタのリストから削除されます。true の場合、AcceptAll ファイルフィルタは実際に使用されるファイルフィルタになります。isAcceptAllFileFilterUsed(), getAcceptAllFileFilter(), setFileFilter(javax.swing.filechooser.FileFilter)public JComponent getAccessory()
setAccessory(javax.swing.JComponent)public void setAccessory(JComponent newAccessory)
注:以前にアクセサリがあった場合は、アクセサリがファイルチューザに登録していた可能性があるすべてのリスナーを登録解除する必要があります。
public void setFileSelectionMode(int mode)
JFileChooser を設定して、ユーザーが、ファイルのみ、ディレクトリのみ、またはファイルとディレクトリの両方を選択できるようにします。デフォルトは JFilesChooser.FILES_ONLY です。mode - 表示されるファイルの種類
IllegalArgumentException - mode が無効なファイル選択モードの場合getFileSelectionMode()public int getFileSelectionMode()
JFilesChooser.FILES_ONLY です。setFileSelectionMode(int)public boolean isFileSelectionEnabled()
public boolean isDirectorySelectionEnabled()
public void setMultiSelectionEnabled(boolean b)
b - 複数のファイルを選択できる場合は trueisMultiSelectionEnabled()public boolean isMultiSelectionEnabled()
setMultiSelectionEnabled(boolean)public boolean isFileHidingEnabled()
setFileHidingEnabled(boolean)public void setFileHidingEnabled(boolean b)
FileView によって行われます。b - ファイルの非表示がオンかオフかを指定する boolean 値isFileHidingEnabled()public void setFileFilter(FileFilter filter)
filter - 使用する新しい現在のファイルフィルタgetFileFilter()public FileFilter getFileFilter()
public void setFileView(FileView fileView)
getFileView()public FileView getFileView()
public String getName(File f)
f - Filef のファイル名を格納する StringFileView.getName(java.io.File)public String getDescription(File f)
f - Filef のファイルの説明を格納する StringFileView.getDescription(java.io.File)public String getTypeDescription(File f)
f - Filef のファイル型の説明を格納する StringFileView.getTypeDescription(java.io.File)public Icon getIcon(File f)
f - FileIconFileView.getIcon(java.io.File)public boolean isTraversable(File f)
f - FileFileView.isTraversable(java.io.File)public boolean accept(File f)
f - FileFileFilter.accept(java.io.File)public void setFileSystemView(FileSystemView fsv)
JFileChooser が使用するファイルシステムビューを設定します。fsv - 新しい FileSystemViewFileSystemViewpublic FileSystemView getFileSystemView()
FileSystemView オブジェクトsetFileSystemView(javax.swing.filechooser.FileSystemView)public void approveSelection()
APPROVE_SELECTION に相当するコマンド文字列を使用してアクションイベントをトリガーします。APPROVE_SELECTIONpublic void cancelSelection()
CANCEL_SELECTION に相当するコマンド文字列を使用してアクションイベントをトリガーします。CANCEL_SELECTIONpublic void addActionListener(ActionListener l)
ActionListener を追加します。l - 追加されるリスナーapproveSelection(), cancelSelection()public void removeActionListener(ActionListener l)
ActionListener を削除します。l - 削除されるリスナーaddActionListener(java.awt.event.ActionListener)public ActionListener[] getActionListeners()
ActionListener。アクションリスナーが現在登録されていない場合は空の配列addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener)protected void fireActionPerformed(String command)
command パラメータで遅延生成されます。EventListenerListpublic void updateUI()
updateUI 、クラス: JComponentJComponent.updateUI()public String getUIClassID()
getUIClassID 、クラス: JComponentJComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)public FileChooserUI getUI()
protected String paramString()
JFileChooser の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。paramString 、クラス: JComponentJFileChooser の文字列表現public AccessibleContext getAccessibleContext()
getAccessibleContext 、インタフェース: AccessiblegetAccessibleContext 、クラス: JComponent バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.