JavaTM Platform
Standard Ed. 6

java.awt
クラス FileDialog

java.lang.Object
  上位を拡張 java.awt.Component
      上位を拡張 java.awt.Container
          上位を拡張 java.awt.Window
              上位を拡張 java.awt.Dialog
                  上位を拡張 java.awt.FileDialog
すべての実装されたインタフェース:
ImageObserver, MenuContainer, Serializable, Accessible

public class FileDialog
extends Dialog

FileDialog クラスは、ユーザーがファイルを選択できるダイアログウィンドウを表示します。

このダイアログはモーダルであるため、アプリケーションがその show メソッドを呼び出してこのダイアログを表示すると、ユーザーがファイルを選択するまでアプリケーションのほかの部分は使用できません。

導入されたバージョン:
JDK1.0
関連項目:
Window.show(), 直列化された形式

入れ子のクラスの概要
 
クラス java.awt.Dialog から継承された入れ子のクラス/インタフェース
Dialog.AccessibleAWTDialog, Dialog.ModalExclusionType, Dialog.ModalityType
 
クラス java.awt.Window から継承された入れ子のクラス/インタフェース
Window.AccessibleAWTWindow
 
クラス java.awt.Container から継承された入れ子のクラス/インタフェース
Container.AccessibleAWTContainer
 
クラス java.awt.Component から継承された入れ子のクラス/インタフェース
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
フィールドの概要
static int LOAD
          この定数値は、ファイルダイアログウィンドウの目的が読み込み用ファイルの検索であることを示します。
static int SAVE
          この定数値は、ファイルダイアログウィンドウの目的が書き込み用ファイルの検索であることを示します。
 
クラス java.awt.Dialog から継承されたフィールド
DEFAULT_MODALITY_TYPE
 
クラス 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
 
コンストラクタの概要
FileDialog(Dialog parent)
          ファイルをロードするためのファイルダイアログを生成します。
FileDialog(Dialog parent, String title)
          指定されたタイトルを使用して、ファイルをロードするためのファイルダイアログウィンドウを生成します。
FileDialog(Dialog parent, String title, int mode)
          指定されたタイトルを使用して、ファイルをロードまたは保存するためのファイルダイアログウィンドウを生成します。
FileDialog(Frame parent)
          ファイルをロードするためのファイルダイアログを生成します。
FileDialog(Frame parent, String title)
          指定されたタイトルを使用して、ファイルをロードするためのファイルダイアログウィンドウを生成します。
FileDialog(Frame parent, String title, int mode)
          指定されたタイトルを使用して、ファイルをロードまたは保存するためのファイルダイアログウィンドウを生成します。
 
メソッドの概要
 void addNotify()
          ファイルダイアログのピアを作成します。
 String getDirectory()
          このファイルダイアログのディレクトリを返します。
 String getFile()
          このファイルダイアログの選択されているファイルを返します。
 FilenameFilter getFilenameFilter()
          このファイルダイアログのファイル名フィルタを調べます。
 int getMode()
          このファイルダイアログボックスがファイルからロードするためのものか、ファイルに保存するためのものかを示します。
protected  String paramString()
          この FileDialog ウィンドウの状態を表す文字列を返します。
 void setDirectory(String dir)
          このファイルダイアログウィンドウのディレクトリを、指定されたディレクトリに設定します。
 void setFile(String file)
          このファイルダイアログウィンドウの選択されているファイルを、指定されたファイルに設定します。
 void setFilenameFilter(FilenameFilter filter)
          ファイルダイアログウィンドウのファイル名フィルタを指定されたフィルタに設定します。
 void setMode(int mode)
          ファイルダイアログのモードを設定します。
 
クラス java.awt.Dialog から継承されたメソッド
getAccessibleContext, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setModalityType, setResizable, setTitle, setUndecorated, setVisible, show, toBack
 
クラス java.awt.Window から継承されたメソッド
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOwnedWindows, getOwner, getOwnerlessWindows, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, toFront
 
クラス java.awt.Container から継承されたメソッド
add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, validate, validateTree
 
クラス java.awt.Component から継承されたメソッド
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, setBackground, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusUpCycle
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

LOAD

public static final int LOAD
この定数値は、ファイルダイアログウィンドウの目的が読み込み用ファイルの検索であることを示します。

関連項目:
定数フィールド値

SAVE

public static final int SAVE
この定数値は、ファイルダイアログウィンドウの目的が書き込み用ファイルの検索であることを示します。

関連項目:
定数フィールド値
コンストラクタの詳細

FileDialog

public FileDialog(Frame parent)
ファイルをロードするためのファイルダイアログを生成します。ファイルダイアログのタイトルは最初は空です。これは FileDialog(parent, "", LOAD) の簡易メソッドです。

パラメータ:
parent - ダイアログの所有者
導入されたバージョン:
JDK1.1

FileDialog

public FileDialog(Frame parent,
                  String title)
指定されたタイトルを使用して、ファイルをロードするためのファイルダイアログウィンドウを生成します。現在のディレクトリのファイルが表示されます。これは FileDialog(parent, title, LOAD) の簡易メソッドです。

パラメータ:
parent - ダイアログの所有者
title - ダイアログのタイトル

FileDialog

public FileDialog(Frame parent,
                  String title,
                  int mode)
指定されたタイトルを使用して、ファイルをロードまたは保存するためのファイルダイアログウィンドウを生成します。

mode の値が LOAD の場合、ファイルダイアログは読み込み用のファイルを検索します。mode の値が SAVE の場合、ファイルダイアログはファイルの書き込み先を検索します。

パラメータ:
parent - ダイアログの所有者
title - ダイアログのタイトル
mode - このダイアログのモード。FileDialog.LOAD または FileDialog.SAVE
例外:
IllegalArgumentException - ファイルダイアログのモードが不当な場合
関連項目:
LOAD, SAVE

FileDialog

public FileDialog(Dialog parent)
ファイルをロードするためのファイルダイアログを生成します。ファイルダイアログのタイトルは最初は空です。これは FileDialog(parent, "", LOAD) の簡易メソッドです。

パラメータ:
parent - ダイアログの所有者
例外:
IllegalArgumentException - parentGraphicsConfiguration がスクリーンデバイスによらない場合
IllegalArgumentException - parentnull の場合。この例外は GraphicsEnvironment.isHeadlesstrue を返す場合に必ずスローされる
導入されたバージョン:
1.5
関連項目:
GraphicsEnvironment.isHeadless()

FileDialog

public FileDialog(Dialog parent,
                  String title)
指定されたタイトルを使用して、ファイルをロードするためのファイルダイアログウィンドウを生成します。現在のディレクトリのファイルが表示されます。これは FileDialog(parent, title, LOAD) の簡易メソッドです。

パラメータ:
parent - ダイアログの所有者
title - ダイアログのタイトル。null 値も指定可能であり、NullPointerException はスローされない
例外:
IllegalArgumentException - parentGraphicsConfiguration がスクリーンデバイスによらない場合
IllegalArgumentException - parentnull の場合。この例外は GraphicsEnvironment.isHeadlesstrue を返す場合に必ずスローされる
導入されたバージョン:
1.5
関連項目:
GraphicsEnvironment.isHeadless()

FileDialog

public FileDialog(Dialog parent,
                  String title,
                  int mode)
指定されたタイトルを使用して、ファイルをロードまたは保存するためのファイルダイアログウィンドウを生成します。

mode の値が LOAD の場合、ファイルダイアログは読み込み用のファイルを検索します。mode の値が SAVE の場合、ファイルダイアログはファイルの書き込み先を検索します。

パラメータ:
parent - ダイアログの所有者
title - ダイアログのタイトル。null 値も指定可能であり、NullPointerException はスローされない
mode - このダイアログのモード。FileDialog.LOAD または FileDialog.SAVE
例外:
IllegalArgumentException - ファイルダイアログのモードが不当な場合
IllegalArgumentException - parentGraphicsConfiguration がスクリーンデバイスによらない場合
IllegalArgumentException - parentnull の場合。この例外は GraphicsEnvironment.isHeadlesstrue を返す場合に必ずスローされる
導入されたバージョン:
1.5
関連項目:
GraphicsEnvironment.isHeadless(), LOAD, SAVE
メソッドの詳細

addNotify

public void addNotify()
ファイルダイアログのピアを作成します。ファイルダイアログの機能を変更せずに、その外観の変更を可能にします。

オーバーライド:
クラス Dialog 内の addNotify
関連項目:
Component.isDisplayable(), Window.removeNotify()

getMode

public int getMode()
このファイルダイアログボックスがファイルからロードするためのものか、ファイルに保存するためのものかを示します。

戻り値:
このファイルダイアログウィンドウのモード。FileDialog.LOAD または FileDialog.SAVE
関連項目:
LOAD, SAVE, setMode(int)

setMode

public void setMode(int mode)
ファイルダイアログのモードを設定します。mode が不当な値の場合は例外がスローされ、mode は設定されません。

パラメータ:
mode - このファイルダイアログのモード。FileDialog.LOAD または FileDialog.SAVE
例外:
IllegalArgumentException - ファイルダイアログのモードが不当な場合
導入されたバージョン:
JDK1.1
関連項目:
LOAD, SAVE, getMode()

getDirectory

public String getDirectory()
このファイルダイアログのディレクトリを返します。

戻り値:
この FileDialog のディレクトリ。null の場合や無効なディレクトリの場合もある
関連項目:
setDirectory(java.lang.String)

setDirectory

public void setDirectory(String dir)
このファイルダイアログウィンドウのディレクトリを、指定されたディレクトリに設定します。null または無効なディレクトリを指定すると、システムで定義されているデフォルトに設定されます。ただし、このデフォルトはユーザーがファイルを選択したときに設定されます。そのときまでは、getDirectory() はこのメソッドに渡された値を返します。

ディレクトリとして "" を指定すると、null に設定されます。

パラメータ:
dir - 指定されたディレクトリ
関連項目:
getDirectory()

getFile

public String getFile()
このファイルダイアログの選択されているファイルを返します。CANCEL を選択すると null が返されます。

戻り値:
このファイルダイアログウィンドウの現在選択されているファイル。ファイルが選択されていない場合は null
関連項目:
setFile(java.lang.String)

setFile

public void setFile(String file)
このファイルダイアログウィンドウの選択されているファイルを、指定されたファイルに設定します。このファイルは、ファイルダイアログウィンドウが最初に表示される前に設定されている場合はデフォルトファイルになります。

ファイルとして "" を指定すると、null に設定されます。

パラメータ:
file - 設定されるファイル
関連項目:
getFile()

getFilenameFilter

public FilenameFilter getFilenameFilter()
このファイルダイアログのファイル名フィルタを調べます。ファイル名フィルタを使用すると、ユーザーはファイルダイアログに表示されるファイルを限定できます。ファイル名フィルタは、Microsoft Windows 用の Sun の参照実装では機能しません。

戻り値:
このファイルダイアログのファイル名フィルタ
関連項目:
FilenameFilter, setFilenameFilter(java.io.FilenameFilter)

setFilenameFilter

public void setFilenameFilter(FilenameFilter filter)
ファイルダイアログウィンドウのファイル名フィルタを指定されたフィルタに設定します。ファイル名フィルタは、Microsoft Windows 用の Sun の参照実装では機能しません。

パラメータ:
filter - 指定されたフィルタ
関連項目:
FilenameFilter, getFilenameFilter()

paramString

protected String paramString()
この FileDialog ウィンドウの状態を表す文字列を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

オーバーライド:
クラス Dialog 内の paramString
戻り値:
このファイルダイアログウィンドウのパラメータ文字列

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2009 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。