java.awt.FileDialog

すべての実装されたインタフェース:: ImageObserver, MenuContainer, Serializable, Accessible

public class FileDialog extends Dialog

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

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

導入されたバージョン:

1.0

関連項目:

ネストされたクラスのサマリー

クラス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 final int

LOAD

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

static final 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

クラスjava.lang.Objectで宣言されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

フィールド詳細
- LOAD
  @Native public static final int LOAD
  
  この定数値は、ファイル・ダイアログ・ウィンドウの目的が読込み用ファイルの検索であることを示します。
  
  関連項目:
  
  定数フィールド値
- SAVE
  @Native public static final int SAVE
  
  この定数値は、ファイル・ダイアログ・ウィンドウの目的が書込み用ファイルの検索であることを示します。
  
  関連項目:
  
  定数フィールド値
コンストラクタの詳細
- 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
  
  戻り値:
  
  このファイル・ダイアログ・ウィンドウのパラメータ文字列

クラスFileDialog

ネストされたクラスのサマリー

クラスjava.awt.Dialogで宣言されたネストされたクラス/インタフェース

クラスjava.awt.Windowで宣言されたネストされたクラス/インタフェース

クラスjava.awt.Containerで宣言されたネストされたクラス/インタフェース

クラスjava.awt.Componentで宣言されたネストされたクラス/インタフェース

フィールドのサマリー

クラスjava.awt.Dialogで宣言されたフィールド

クラスjava.awt.Componentで宣言されたフィールド

インタフェースjava.awt.image.ImageObserverで宣言されているフィールド

コンストラクタのサマリー

メソッドのサマリー

クラスjava.awt.Dialogで宣言されたメソッド

クラスjava.awt.Windowで宣言されたメソッド

クラスjava.awt.Containerで宣言されたメソッド

クラスjava.awt.Componentで宣言されたメソッド

クラスjava.lang.Objectで宣言されたメソッド

フィールド詳細

LOAD

SAVE

コンストラクタの詳細

FileDialog

FileDialog

FileDialog

FileDialog

FileDialog

FileDialog

メソッドの詳細

setTitle

addNotify

getMode

setMode

getDirectory

setDirectory

getFile

getFiles

setFile

setMultipleMode

isMultipleMode

getFilenameFilter

setFilenameFilter

paramString