java.lang.Object
javax.swing.filechooser.FileSystemView
public abstract class FileSystemView extends Object
FileSystemViewは、JFileChooserが使用する、ファイル・システムへのゲートウェイです。 JDK1.1 File APIはルート・パーティション、ファイルの種類、隠しファイルのフラグ・ビットなどの情報へのアクセスを許可しないため、このクラスはOS固有のファイル・システムに関するできるだけ多くの情報について、その概要が直観的に把握できるように設計されています。
Javaのライセンスは、特定のオペレーティング・システムをより効率よく処理するためにFileSystemViewの異なる実装を提供できます。
-
コンストラクタのサマリー
コンストラクタ -
メソッドのサマリー
修飾子と型メソッド説明createFileObject
(File dir, String filename) 指定されたファイル名でdirに作成されたFileオブジェクトを返します。createFileObject
(String path) 指定されたパス文字列から作成されたFileオブジェクトを返します。protected File
ファイル・システムのルート・ディレクトリに対して正しく動作するf
用の新しいFile
オブジェクトを作成します。abstract File
createNewFolder
(File containingDir) デフォルトのフォルダ名で新しいフォルダを作成します。File[]
ファイル・チューザ・セレクタに表示される値を表すファイルの配列を返します。final File[]
ファイル・チューザのショートカット・パネルにデフォルトで表示される値を表すファイル配列を返します。ファイル・チューザ用のユーザーのデフォルトの起動ディレクトリを返します。File[]
表示されている(非表示でない)ファイルのリストを返します。static FileSystemView
ファイル・システム・ビューを返します。ホーム・ディレクトリを返します。getLinkLocation
(File file) 指定されたファイルがシェルの解釈済みリンクである場合、指定されたリンク・ファイルが参照する通常のファイルを返します。getParentDirectory
(File dir) dir
の親ディレクトリを返します。File[]
getRoots()
このシステムのすべてのルート・パーティションを返します。システム・ファイル・ブラウザに表示されるファイル、ディレクトリ、またはフォルダの名前です。システム・ファイル・ブラウザに表示されるファイル、ディレクトリ、またはフォルダのアイコンです。getSystemIcon
(File f, int width, int height) リクエストされたサイズのシステム・ファイル・ブラウザに表示されるファイル、ディレクトリ、またはフォルダのアイコンを返します。システム・ファイル・ブラウザに表示されるファイル、ディレクトリ、またはフォルダの種類の説明です。boolean
isComputerNode
(File dir) コンピュータのノードなどを表す特殊なアイコンを表示するかどうかを判断するために、UIクラスによって使用されます。boolean
ドライブやパーティションを表す特殊なアイコン(「ハード・ディスク」アイコンなど)を表示するかどうかを判断するためにUIクラスによって使用されます。boolean
isFileSystem
(File f) f
が"Desktop"
などの特殊なフォルダとは対照的に実際のディレクトリまたはファイルを表しているかどうかを確認します。boolean
isFileSystemRoot
(File dir) dirがドライブやパーティションなど、ファイル・システムのツリーのルートであるかどうかを返します。boolean
isFloppyDrive
(File dir) フロッピー・ディスクを表す特殊なアイコンを表示するかどうかを判断するためにUIクラスによって使用されます。boolean
isHiddenFile
(File f) ファイルが非表示であるかどうかを返します。boolean
指定されたファイルがgetLinkLocation(File)
で取得できるシェルの解釈済みリンクを示すかどうかを返します。boolean
Windowsでは、ファイルはファイル・システムの親ディレクトリではなく、複数のフォルダ内に表示されます。boolean
指定されたファイルがナビゲート可能なツリーのルートであるかどうかを確認します。ファイル(ディレクトリ)に移動できる場合にtrueを返します。
-
コンストラクタの詳細
-
FileSystemView
public FileSystemView()FileSystemViewを構築します。
-
-
メソッドの詳細
-
getFileSystemView
public static FileSystemView getFileSystemView()ファイル・システム・ビューを返します。- 戻り値:
- ファイル・システム・ビュー
-
isRoot
public boolean isRoot(File f) 指定されたファイルがナビゲート可能なツリーのルートであるかどうかを確認します。 たとえば、Windows 98はDesktopフォルダというルートを持ちます。 DOSはC:\
、D:\
などといったドライブ文字ごとに1つのルートを持ちます。UNIXは"/"
ディレクトリというルートを持ちます。 デフォルト実装は、ShellFolder
クラスから情報を取得します。- パラメータ:
f
- ディレクトリを表すFile
オブジェクト- 戻り値:
f
がナビゲート可能なツリーのルートである場合はtrue
。- 関連項目:
-
isTraversable
ファイル(ディレクトリ)に移動できる場合にtrueを返します。 ディレクトリがトラバースできない場合はfalseを返します。- パラメータ:
f
-File
- 戻り値:
- ファイルまたはディレクトリがトラバースできる場合は
true
、そうでない場合はfalse
- 導入されたバージョン:
- 1.4
- 関連項目:
-
getSystemDisplayName
システム・ファイル・ブラウザに表示されるファイル、ディレクトリ、またはフォルダの名前です。 Windowsの例では、M:\ディレクトリは「CD-ROM (M:)」として表示されます。デフォルト実装は、ShellFolderクラスから情報を取得します。- パラメータ:
f
-File
オブジェクト- 戻り値:
- ネイティブのファイル・チューザで表示されるファイル名
- 導入されたバージョン:
- 1.4
- 関連項目:
-
getSystemTypeDescription
システム・ファイル・ブラウザに表示されるファイル、ディレクトリ、またはフォルダの種類の説明です。 Windowsの例では、Desktopフォルダの説明は「デスクトップ」となります。 ネイティブのShellFolderの実装を持つプラットフォーム用のオーバーライドです。- パラメータ:
f
-File
オブジェクト- 戻り値:
- ネイティブのファイル・チューザで表示されるファイルの種類の説明(ネイティブの情報が使用できない場合はnull)。
- 導入されたバージョン:
- 1.4
- 関連項目:
-
getSystemIcon
システム・ファイル・ブラウザに表示されるファイル、ディレクトリ、またはフォルダのアイコンです。 Windowsの例では、M: \ディレクトリはCD-ROMのアイコンで表示されます。デフォルト実装は、ShellFolderクラスから情報を取得します。
- パラメータ:
f
-File
オブジェクト- 戻り値:
- ネイティブのファイル・チューザで表示されるアイコン
- 導入されたバージョン:
- 1.4
- 関連項目:
-
getSystemIcon
リクエストされたサイズのシステム・ファイル・ブラウザに表示されるファイル、ディレクトリ、またはフォルダのアイコンを返します。例:
FileSystemView fsv = FileSystemView.getFileSystemView(); Icon icon = fsv.getSystemIcon(new File("application.exe"), 64, 64); JLabel label = new JLabel(icon);
- 実装要件:
- 使用可能なアイコンはプラットフォーム固有であるため、プラットフォームによって使用可能なサイズが決まります。 したがって、リクエストされたサイズに対する完全一致は不可能です。 戻されるアイコンは複数解像度アイコンのイメージであり、異なるスケーリング係数を持つ高DPI環境をより適切にサポートできます。
- パラメータ:
f
- アイコンを取得するFile
オブジェクトwidth
- ユーザー座標系のアイコンの幅。height
- ユーザー座標系のアイコンの高さ。- 戻り値:
- 存在しないファイル、またはアクセスできないファイルのネイティブ・ファイル・チューザによって表示されるアイコン。
- throws:
IllegalArgumentException
- 負のサイズやNULLファイル参照などの無効なパラメータが渡された場合。- 導入されたバージョン:
- 17
- 関連項目:
-
isParent
Windowsでは、ファイルはファイル・システムの親ディレクトリではなく、複数のフォルダ内に表示されます。 フォルダは、たとえば「デスクトップ」フォルダで、それは、file.getParentFile()とは同じにならない場合があります。- パラメータ:
folder
- aFile
object representing a directory or special folderfile
-File
オブジェクト- 戻り値:
folder
がディレクトリまたは特定のフォルダで、file
を格納する場合はtrue
。- 導入されたバージョン:
- 1.4
-
getChild
- パラメータ:
parent
- aFile
object representing a directory or special folderfileName
-parent
内に存在するファイルまたはフォルダの名前- 戻り値:
- Fileオブジェクト。 通常、これは親または子が両方とも特殊なフォルダではない場合に
new File(parent, fileName)
を使用して構築される。この場合、File
は、ShellFolder
オブジェクトを格納するラッパー。 - 導入されたバージョン:
- 1.4
-
isFileSystem
public boolean isFileSystem(File f) f
が"Desktop"
などの特殊なフォルダとは対照的に実際のディレクトリまたはファイルを表しているかどうかを確認します。 ディレクトリの選択を行うときにフォルダが選択可能かどうかを判断するためにUIクラスが使用します。- パラメータ:
f
-File
オブジェクト- 戻り値:
f
が実際のファイルまたはディレクトリの場合はtrue
。- 導入されたバージョン:
- 1.4
-
createNewFolder
public abstract File createNewFolder(File containingDir) throws IOException デフォルトのフォルダ名で新しいフォルダを作成します。- パラメータ:
containingDir
- 新しいフォルダを格納するディレクトリを示すFile
オブジェクト- 戻り値:
- 新しく作成されたフォルダを示す
File
オブジェクト - throws:
IOException
- 新しいフォルダを作成できなかった場合
-
isHiddenFile
public boolean isHiddenFile(File f) ファイルが非表示であるかどうかを返します。- パラメータ:
f
-File
オブジェクト- 戻り値:
- 指定された
File
が隠しファイルを表す場合はtrue
-
isFileSystemRoot
public boolean isFileSystemRoot(File dir) dirがドライブやパーティションなど、ファイル・システムのツリーのルートであるかどうかを返します。 例: Windows 98ではC:\の場合にtrueを返します。- パラメータ:
dir
- ディレクトリを表すFile
オブジェクト- 戻り値:
f
がファイル・システムのルートである場合はtrue
- 導入されたバージョン:
- 1.4
- 関連項目:
-
isDrive
public boolean isDrive(File dir) ドライブやパーティションを表す特殊なアイコン(「ハード・ディスク」アイコンなど)を表示するかどうかを判断するためにUIクラスによって使用されます。 デフォルトの実装ではこれを調べる方法がないため、常にfalseが返されます。- パラメータ:
dir
- ディレクトリ- 戻り値:
false
(常時)- 導入されたバージョン:
- 1.4
-
isFloppyDrive
public boolean isFloppyDrive(File dir) フロッピー・ディスクを表す特殊なアイコンを表示するかどうかを判断するためにUIクラスによって使用されます。 isDrive(dir)を含みます。 デフォルトの実装ではこれを調べる方法がないため、常にfalseが返されます。- パラメータ:
dir
- ディレクトリ- 戻り値:
false
(常時)- 導入されたバージョン:
- 1.4
-
isComputerNode
public boolean isComputerNode(File dir) コンピュータのノードを表す特殊なアイコン(My Computerやネットワーク・サーバーなど)を表示するかどうかを判断するためにUIクラスによって使用されます。 デフォルトの実装ではこれを調べる方法がないため、常にfalseが返されます。- パラメータ:
dir
- ディレクトリ- 戻り値:
false
(常時)- 導入されたバージョン:
- 1.4
-
getRoots
public File[] getRoots()このシステムのすべてのルート・パーティションを返します。 たとえば、Windowsの場合、これはDesktopフォルダとなり、DOSの場合、A: からZ: までのドライブになります。- 戻り値:
- このシステム上のすべてのルート・パーティションを表す
File
オブジェクトの配列
-
getHomeDirectory
public File getHomeDirectory()ホーム・ディレクトリを返します。- 戻り値:
- ホーム・ディレクトリ
-
getDefaultDirectory
public File getDefaultDirectory()ファイル・チューザ用のユーザーのデフォルトの起動ディレクトリを返します。- 戻り値:
- デフォルトの起動フォルダを表す
File
オブジェクト - 導入されたバージョン:
- 1.4
-
createFileObject
指定されたファイル名でdirに作成されたFileオブジェクトを返します。- パラメータ:
dir
- ディレクトリを示す抽象パス名filename
- パス名のString
表現- 戻り値:
dir
およびfilename
から作成されたFile
オブジェクト
-
createFileObject
指定されたパス文字列から作成されたFileオブジェクトを返します。- パラメータ:
path
- パスのString
表現- 戻り値:
- 指定された
path
から作成されたFile
オブジェクト
-
getFiles
表示されている(非表示でない)ファイルのリストを返します。- パラメータ:
dir
- 返されるファイルのルート・ディレクトリuseFileHiding
- 隠しファイルが返されるかどうかを判断- 戻り値:
- 指定された
dir
のファイルとディレクトリを表すFile
オブジェクトの配列。useFileHiding
がfalseの場合、隠しファイルが含まれます。
-
getParentDirectory
dir
の親ディレクトリを返します。- パラメータ:
dir
- 照会されるFile
- 戻り値:
dir
の親ディレクトリ(dir
がnull
の場合はnull
)
-
getChooserComboBoxFiles
public File[] getChooserComboBoxFiles()ファイル・チューザ・セレクタに表示される値を表すファイルの配列を返します。- 戻り値:
File
オブジェクトの配列。 返される配列は、適切な権限がない場合は空である可能性があります。- 導入されたバージョン:
- 9
-
getChooserShortcutPanelFiles
public final File[] getChooserShortcutPanelFiles()ファイル・チューザのショートカット・パネルにデフォルトで表示される値を表すファイル配列を返します。- 戻り値:
File
オブジェクトの配列。 返される配列は、適切な権限がない場合は空である可能性があります。- 導入されたバージョン:
- 12
-
isLink
public boolean isLink(File file) 指定されたファイルがgetLinkLocation(File)
で取得できるシェルの解釈済みリンクを示すかどうかを返します。- パラメータ:
file
- ファイル- 戻り値:
- これがリンクかどうか
- throws:
NullPointerException
-file
がnull
と等しい場合SecurityException
- 呼び出し元に必要な権限がない場合- 導入されたバージョン:
- 9
- 関連項目:
-
getLinkLocation
public File getLinkLocation(File file) throws FileNotFoundException 指定されたファイルがシェルの解釈済みリンクである場合、指定されたリンク・ファイルが参照する通常のファイルを返します。 指定されたファイルがシェルの解釈済みリンクでない場合は、null
を返します。- パラメータ:
file
- ファイル- 戻り値:
- リンクされたファイルまたは
null
。 - throws:
FileNotFoundException
- リンクされたファイルが存在しない場合NullPointerException
-file
がnull
と等しい場合SecurityException
- 呼び出し元に必要な権限がない場合- 導入されたバージョン:
- 9
-
createFileSystemRoot
ファイル・システムのルート・ディレクトリに対して正しく動作するf
用の新しいFile
オブジェクトを作成します。- パラメータ:
f
- ファイル・システムのルート・ディレクトリを表すFile
オブジェクト。たとえばUNIXの場合は/、Windowsの場合はC:\。- 戻り値:
- 新しい
File
オブジェクト - 導入されたバージョン:
- 1.4
-