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

クラス java.awt.Window から継承された入れ子のクラス/インタフェース

Window.AccessibleAWTWindow

クラス java.awt.Container から継承された入れ子のクラス/インタフェース

Container.AccessibleAWTContainer

クラス java.awt.Component から継承された入れ子のクラス/インタフェース

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドの概要

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

クラス 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, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setResizable, setTitle, setUndecorated, show

クラス java.awt.Window から継承されたメソッド

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, finalize, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, isActive, isAlwaysOnTop, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setAlwaysOnTop, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setLocationByPlatform, setLocationRelativeTo, toBack, 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, removeNotify, 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, 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, reshape, resize, resize, setBackground, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, size, toString, transferFocus, transferFocusUpCycle

クラス java.lang.Object から継承されたメソッド

clone, equals, 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 - parent の GraphicsConfiguration がスクリーンデバイスによらない場合

IllegalArgumentException - parent が null の場合。この例外は GraphicsEnvironment.isHeadless が true の場合は常にスローされる

導入されたバージョン:

1.5

関連項目:

GraphicsEnvironment.isHeadless()

FileDialog

public FileDialog(Dialog parent,
                  String title)

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

パラメータ:

parent - ダイアログの所有者

title - ダイアログのタイトル。null 値も指定可能であり、NullPointerException はスローされない

例外:

IllegalArgumentException - parent の GraphicsConfiguration がスクリーンデバイスによらない場合

IllegalArgumentException - parent が null の場合。この例外は GraphicsEnvironment.isHeadless が true の場合は常にスローされる

導入されたバージョン:

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 - parent の GraphicsConfiguration がスクリーンデバイスによらない場合

IllegalArgumentException - parent が null の場合。この例外は GraphicsEnvironment.isHeadless が true の場合は常にスローされる

導入されたバージョン:

1.5

関連項目:

GraphicsEnvironment.isHeadless(), LOAD, SAVE

メソッドの詳細

addNotify

public void addNotify()

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

オーバーライド:

クラス Dialog 内の addNotify

関連項目:

Component.isDisplayable(), Container.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

戻り値:

このファイルダイアログウィンドウのパラメータ文字列