- 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
メソッドを呼び出してこのダイアログを表示すると、ユーザーがファイルを選択するまでアプリケーションのほかの部分は使用できません。- 導入されたバージョン:
- 1.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)
ファイル・ダイアログでの複数ファイル選択を有効または無効にします。void
setTitle(String title)
Dialogのタイトルを設定します。-
クラス java.awt.Dialogで宣言されたメソッド
getAccessibleContext, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setModalityType, setResizable, 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, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBackground, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setOpacity, setShape, 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, removeNotify, 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, 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, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
-
-
-
コンストラクタの詳細
-
FileDialog
public FileDialog(Frame parent)
ファイルをロードするためのファイル・ダイアログを生成します。 ファイル・ダイアログのタイトルは最初は空です。 これはFileDialog(parent, "", LOAD)
の簡易メソッドです。ノート: 一部のプラットフォームでは、ファイル・ダイアログでユーザー指定のタイトルを表示できない場合があります。 この状況では、タイトルはファイル・ダイアログ・タイトル・バーに表示されないか、または一部のシステムではファイル・ダイアログ・タイトル・バーが表示されません。
- パラメータ:
parent
- ダイアログの所有者- 導入されたバージョン:
- 1.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
-
-
メソッドの詳細
-
setTitle
public void setTitle(String title)
Dialogのタイトルを設定します。ノート: 一部のプラットフォームでは、ファイル・ダイアログでユーザー指定のタイトルを表示できない場合があります。 この状況では、タイトルはファイル・ダイアログ・タイトル・バーに表示されないか、または一部のシステムではファイル・ダイアログ・タイトル・バーが表示されません。
- オーバーライド:
- クラス
Dialog
のsetTitle
- パラメータ:
title
- ダイアログのボーダーに表示されるタイトル。nullの場合、空のタイトルが表示される- 関連項目:
Dialog.getTitle()
-
addNotify
public void addNotify()
ファイル・ダイアログのピアを作成します。 ファイル・ダイアログの機能を変更せずに、その外観の変更を可能にします。- オーバーライド:
addNotify
、クラスDialog
- 関連項目:
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
- 不正なファイル・ダイアログのモードが指定された場合- 導入されたバージョン:
- 1.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
- 戻り値:
- このファイル・ダイアログ・ウィンドウのパラメータ文字列
-
-