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から継承されたフィールド

accessibleContext, 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)

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

ダイアログを表示したときに、指定されたファイルが選択されます。選択の種類は、ファイルの有無、ダイアログ型およびネイティブ・プラットフォームによって異なります。たとえば、ファイル・リスト内でファイルが強調表示されたり、ファイル名の編集ボックスにファイル名が設定されたりします。

このメソッドはファイルのフル・パスを受け入れます。setDirectoryメソッドを組み合わせて使用した場合は、拡張子付きのファイル名を受け入れます。

ファイルとして""を指定すると、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

戻り値:

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