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, Window.Type

クラス 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() このファイルダイアログのファイル名フィルタを調べます。
File[]	getFiles() ユーザーが選択するファイルを返します。
int	getMode() このファイルダイアログボックスがファイルからロードするためのものか、ファイルに保存するためのものかを示します。
boolean	isMultipleMode() ファイルダイアログで複数ファイル選択が許可されるかどうかを返します。
protected String	paramString() この FileDialog ウィンドウの状態を表す文字列表現を返します。
void	setDirectory(String dir) このファイルダイアログウィンドウのディレクトリを指定されたディレクトリに設定します。
void	setFile(String file) このファイルダイアログウィンドウの選択されているファイルを、指定されたファイルに設定します。
void	setFilenameFilter(FilenameFilter filter) ファイルダイアログウィンドウのファイル名フィルタを指定されたフィルタに設定します。
void	setMode(int mode) ファイルダイアログのモードを設定します。
void	setMultipleMode(boolean enable) ファイルダイアログでの複数ファイル選択を有効または無効にします。

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

getAccessibleContext, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, setUndecorated, setVisible, show, toBack

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

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, 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, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, 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, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, 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, 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, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, 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 - 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()

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

オーバーライド:

addNotify、クラス: Dialog

関連項目:

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)

getFiles

public File[] getFiles()

ユーザーが選択するファイルを返します。

ユーザーがファイルダイアログを取り消した場合、このメソッドは空の配列を返します。

戻り値:

ユーザーが選択したファイル。ユーザーがファイルダイアログを取り消した場合は空の配列。

導入されたバージョン:

1.7

関連項目:

setFile(String), getFile()

setFile

public void setFile(String file)

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

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

パラメータ:

file - 設定されるファイル

関連項目:

getFile(), getFiles()

setMultipleMode

public void setMultipleMode(boolean enable)

ファイルダイアログでの複数ファイル選択を有効または無効にします。

パラメータ:

enable - true の場合は複数ファイル選択が有効、false の場合は無効。

導入されたバージョン:

1.7

関連項目:

isMultipleMode()

isMultipleMode

public boolean isMultipleMode()

ファイルダイアログで複数ファイル選択が許可されるかどうかを返します。

戻り値:

ファイルダイアログで複数ファイル選択が許可される場合は true、そうでない場合は false。

導入されたバージョン:

1.7

関連項目:

setMultipleMode(boolean)

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 にはなりません。

オーバーライド:

paramString、クラス: Dialog

戻り値:

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