クラスFileSystemView

java.lang.Object
javax.swing.filechooser.FileSystemView
public abstract class FileSystemView extends Object
FileSystemViewは、JFileChooserが使用する、ファイル・システムへのゲートウェイです。 JDK1.1 File APIはルート・パーティション、ファイルの種類、隠しファイルのフラグ・ビットなどの情報へのアクセスを許可しないため、このクラスはOS固有のファイル・システムに関するできるだけ多くの情報について、その概要が直観的に把握できるように設計されています。

Javaのライセンスは、特定のオペレーティング・システムをより効率よく処理するためにFileSystemViewの異なる実装を提供できます。

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

    コンストラクタ
    コンストラクタ
    説明
    FileSystemView()
    FileSystemViewを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    File
    createFileObject(File dir, String filename)
    指定されたファイル名でdirに作成されたFileオブジェクトを返します。
    File
    createFileObject(String path)
    指定されたパス文字列から作成されたFileオブジェクトを返します。
    protected File
    createFileSystemRoot(File f)
    ファイル・システムのルート・ディレクトリに対して正しく動作するf用の新しいFileオブジェクトを作成します。
    abstract File
    createNewFolder(File containingDir)
    デフォルトのフォルダ名で新しいフォルダを作成します。
    File
    getChild(File parent, String fileName)
    通常はnew File(parent, fileName)を使用して構築されるFileオブジェクトを返します。ただし、親と子の両方が特別なフォルダである場合を除きます。この場合、FileはShellFolderオブジェクトを含むラッパーです。
    File[]
    getChooserComboBoxFiles()
    ファイル・チューザ・セレクタに表示される値を表すファイルの配列を返します。
    final File[]
    getChooserShortcutPanelFiles()
    ファイル・チューザのショートカット・パネルにデフォルトで表示される値を表すファイル配列を返します。
    File
    getDefaultDirectory()
    ファイル・チューザ用のユーザーのデフォルトの起動ディレクトリを返します。
    File[]
    getFiles(File dir, boolean useFileHiding)
    表示されている(非表示でない)ファイルのリストを返します。
    static FileSystemView
    getFileSystemView()
    ファイル・システム・ビューを返します。
    File
    getHomeDirectory()
    ホーム・ディレクトリを返します。
    File
    getLinkLocation(File file)
    指定されたファイルがシェル解釈リンクである場合、指定されたリンク・ファイルによって参照される通常ファイルを返します。
    File
    getParentDirectory(File dir)
    dirの親ディレクトリを返します。
    File[]
    getRoots()
    このシステムのすべてのルート・パーティションを返します。
    String
    getSystemDisplayName(File f)
    システム・ファイル・ブラウザに表示されるファイル、ディレクトリ、またはフォルダの名前です。
    Icon
    getSystemIcon(File f)
    システム・ファイル・ブラウザに表示されるファイル、ディレクトリ、またはフォルダのアイコンです。
    Icon
    getSystemIcon(File f, int width, int height)
    リクエストされたサイズのシステム・ファイル・ブラウザに表示されるファイル、ディレクトリ、またはフォルダのアイコンを返します。
    String
    getSystemTypeDescription(File f)
    システム・ファイル・ブラウザに表示されるファイル、ディレクトリ、またはフォルダの種類の説明です。
    boolean
    isComputerNode(File dir)
    コンピュータのノードなどを表す特殊なアイコンを表示するかどうかを判断するために、UIクラスによって使用されます。
    boolean
    isDrive(File dir)
    ドライブやパーティションを表す特殊なアイコン(「ハード・ディスク」アイコンなど)を表示するかどうかを判断するためにUIクラスによって使用されます。
    boolean
    isFileSystem(File f)
    fが"Desktop"などの特殊なフォルダとは対照的に実際のディレクトリまたはファイルを表しているかどうかを確認します。
    boolean
    isFileSystemRoot(File dir)
    dirがドライブやパーティションなど、ファイル・システムのツリーのルートであるかどうかを返します。
    boolean
    isFloppyDrive(File dir)
    フロッピー・ディスクを表す特殊なアイコンを表示するかどうかを判断するためにUIクラスによって使用されます。
    boolean
    isHiddenFile(File f)
    ファイルが非表示であるかどうかを返します。
    boolean
    isLink(File file)
    指定されたファイルがgetLinkLocation(File)で取得できるシェルの解釈済みリンクを示すかどうかを返します。
    boolean
    isParent(File folder, File file)
    Windowsでは、ファイルはファイル・システムの親ディレクトリではなく、複数のフォルダ内に表示されます。
    boolean
    isRoot(File f)
    指定されたファイルがナビゲート可能なツリーのルートであるかどうかを確認します。
    Boolean
    isTraversable(File f)
    ファイル(ディレクトリ)に移動できる場合にtrueを返します。

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

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

  • コンストラクタの詳細

    • 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

      public Boolean isTraversable(File f)
      ファイル(ディレクトリ)に移動できる場合にtrueを返します。 ディレクトリがトラバースできない場合はfalseを返します。
      パラメータ:
      f - File
      戻り値:
      ファイルまたはディレクトリがトラバースできる場合はtrue、そうでない場合はfalse
      導入されたバージョン:
      1.4
      関連項目:

    • getSystemDisplayName

      public String getSystemDisplayName(File f)
      システム・ファイル・ブラウザに表示されるファイル、ディレクトリ、またはフォルダの名前です。 Windowsの例では、M:\ディレクトリは「CD-ROM (M:)」として表示されます。デフォルト実装は、ShellFolderクラスから情報を取得します。
      パラメータ:
      f - Fileオブジェクト
      戻り値:
      ネイティブのファイル・チューザで表示されるファイル名
      導入されたバージョン:
      1.4
      関連項目:

    • getSystemTypeDescription

      public String getSystemTypeDescription(File f)
      システム・ファイル・ブラウザに表示されるファイル、ディレクトリ、またはフォルダの種類の説明です。 Windowsの例では、Desktopフォルダの説明は「デスクトップ」となります。 ネイティブのShellFolderの実装を持つプラットフォーム用のオーバーライドです。
      パラメータ:
      f - Fileオブジェクト
      戻り値:
      ネイティブのファイル・チューザで表示されるファイルの種類の説明(ネイティブの情報が使用できない場合はnull)。
      導入されたバージョン:
      1.4
      関連項目:

    • getSystemIcon

      public Icon getSystemIcon(File f)
      システム・ファイル・ブラウザに表示されるファイル、ディレクトリ、またはフォルダのアイコンです。 Windowsの例では、M: \ディレクトリはCD-ROMのアイコンで表示されます。

      デフォルト実装は、ShellFolderクラスから情報を取得します。

      パラメータ:
      f - Fileオブジェクト
      戻り値:
      ネイティブのファイル・チューザで表示されるアイコン
      導入されたバージョン:
      1.4
      関連項目:

    • getSystemIcon

      public Icon getSystemIcon(File f, int width, int height)
      リクエストされたサイズのシステム・ファイル・ブラウザに表示されるファイル、ディレクトリ、またはフォルダのアイコンを返します。

      例: 

           FileSystemView fsv = FileSystemView.getFileSystemView();
     Icon icon = fsv.getSystemIcon(new File("application.exe"), 64, 64);
     JLabel label = new JLabel(icon);

      実装要件:
      使用可能なアイコンはプラットフォーム固有であるため、プラットフォームによって使用可能なサイズが決まります。 したがって、リクエストされたサイズに対する完全一致は不可能です。 戻されるアイコンは複数解像度アイコンのイメージであり、異なるスケーリング係数を持つ高DPI環境をより適切にサポートできます。
      パラメータ:
      f - アイコンを取得するFileオブジェクト
      width - ユーザー座標系のアイコンの幅。
      height - ユーザー座標系のアイコンの高さ。
      戻り値:
      存在しないファイル、またはアクセスできないファイルのネイティブ・ファイル・チューザによって表示されるアイコン。
      スロー:
      IllegalArgumentException - 負のサイズやNULLファイル参照などの無効なパラメータが渡された場合。
      導入されたバージョン:
      17
      関連項目:

    • isParent

      public boolean isParent(File folder, File file)
      Windowsでは、ファイルはファイル・システムの親ディレクトリではなく、複数のフォルダ内に表示されます。 フォルダは、たとえば「デスクトップ」フォルダで、それは、file.getParentFile()とは同じにならない場合があります。
      パラメータ:
      folder - a File object representing a directory or special folder
      file - Fileオブジェクト
      戻り値:
      folderがディレクトリまたは特定のフォルダで、fileを格納する場合はtrue。
      導入されたバージョン:
      1.4

    • getChild

      public File getChild(File parent, String fileName)
      通常はnew File(parent, fileName)を使用して構築されるFileオブジェクトを返します。ただし、親と子の両方が特別なフォルダである場合を除きます。この場合、FileはShellFolderオブジェクトを含むラッパーです。
      パラメータ:
      parent - a File object representing a directory or special folder
      fileName - parent内に存在するファイルまたはフォルダの名前
      戻り値:
      Fileオブジェクト。
      導入されたバージョン:
      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オブジェクト
      スロー:
      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

      public File createFileObject(File dir, String filename)
      指定されたファイル名でdirに作成されたFileオブジェクトを返します。
      パラメータ:
      dir - ディレクトリを示す抽象パス名
      filename - パス名のString表現
      戻り値:
      dirおよびfilenameから作成されたFileオブジェクト

    • createFileObject

      public File createFileObject(String path)
      指定されたパス文字列から作成されたFileオブジェクトを返します。
      パラメータ:
      path - パスのString表現
      戻り値:
      指定されたpathから作成されたFileオブジェクト

    • getFiles

      public File[] getFiles(File dir, boolean useFileHiding)
      表示されている(非表示でない)ファイルのリストを返します。
      パラメータ:
      dir - 返されるファイルのルート・ディレクトリ
      useFileHiding - 隠しファイルが返されるかどうかを判断
      戻り値:
      指定されたdirのファイルとディレクトリを表すFileオブジェクトの配列。 useFileHidingがfalseの場合、非表示ファイルが含まれます。

    • getParentDirectory

      public File getParentDirectory(File dir)
      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 - ファイル
      戻り値:
      これがリンクかどうか
      スロー:
      NullPointerException - fileがnullと等しい場合
      導入されたバージョン:
      9
      関連項目:

    • getLinkLocation

      public File getLinkLocation(File file) throws FileNotFoundException
      指定されたファイルがシェル解釈リンクである場合、指定されたリンク・ファイルによって参照される通常ファイルを返します。 指定されたファイルがシェル解釈リンクでない場合、nullを返します。
      パラメータ:
      file - ファイル
      戻り値:
      リンクされたファイルまたはnull。
      スロー:
      FileNotFoundException - リンクされたファイルが存在しない場合
      NullPointerException - fileがnullと等しい場合
      導入されたバージョン:
      9

    • createFileSystemRoot

      protected File createFileSystemRoot(File f)
      ファイル・システムのルート・ディレクトリに対して正しく動作するf用の新しいFileオブジェクトを作成します。
      パラメータ:
      f - ファイル・システムのルート・ディレクトリを表すFileオブジェクト。たとえばUNIXの場合は/、Windowsの場合はC:\。
      戻り値:
      新しいFileオブジェクト
      導入されたバージョン:
      1.4