OpenFileDialog クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザーが開く 1 つ以上のファイルのファイル名を指定できる一般的なダイアログ ボックスを表します。
public ref class OpenFileDialog sealed : Microsoft::Win32::FileDialogpublic sealed class OpenFileDialog : Microsoft.Win32.FileDialogtype OpenFileDialog = class
inherit FileDialogPublic NotInheritable Class OpenFileDialog
Inherits FileDialog- 継承
例
次の例は、既定のファイル名と拡張子の種類を含む OpenFileDialog を作成する方法を示しています。
// Configure open file dialog box
Microsoft.Win32.OpenFileDialog dlg = new Microsoft.Win32.OpenFileDialog();
dlg.FileName = "Document"; // Default file name
dlg.DefaultExt = ".txt"; // Default file extension
dlg.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension
// Show open file dialog box
Nullable<bool> result = dlg.ShowDialog();
// Process open file dialog box results
if (result.Value)
{
// Open document
string filename = dlg.FileName;
}
' Configure open file dialog box
Dim dlg As New Microsoft.Win32.OpenFileDialog()
dlg.FileName = "Document" ' Default file name
dlg.DefaultExt = ".txt" ' Default file extension
dlg.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension
' Show open file dialog box
Dim result? As Boolean = dlg.ShowDialog()
' Process open file dialog box results
If result = True Then
' Open document
Dim filename As String = dlg.FileName
End If
注釈
XAML でこのマネージド クラスを宣言することはできません。
コンストラクター
| 名前 | 説明 |
|---|---|
| OpenFileDialog() |
OpenFileDialog クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| AddExtension |
ユーザーが拡張子を省略した場合に、ファイル ダイアログで自動的に拡張子をファイル名に追加するかどうかを示す値を取得または設定します。 (継承元 FileDialog) |
| CheckFileExists |
ユーザーが存在しないファイル名を指定した場合に、ファイル ダイアログに警告を表示するかどうかを示す値を取得または設定します。 (継承元 FileDialog) |
| CheckPathExists |
ユーザーが無効なパスとファイル名を入力した場合に警告を表示するかどうかを指定する値を取得または設定します。 (継承元 FileDialog) |
| CustomPlaces |
ファイル ダイアログ ボックスのカスタムの場所の一覧を取得または設定します。 (継承元 FileDialog) |
| DefaultExt |
表示されるファイルの一覧をフィルター処理するために使用する既定の拡張文字列を指定する値を取得または設定します。 (継承元 FileDialog) |
| DereferenceLinks |
ファイル ダイアログが、ショートカットによって参照されるファイルの場所またはショートカット ファイルの場所 (.lnk) を返すかどうかを示す値を取得または設定します。 (継承元 FileDialog) |
| FileName |
ファイル ダイアログで選択したファイルの完全なパスを含む文字列を取得または設定します。 (継承元 FileDialog) |
| FileNames |
選択したファイルごとに 1 つのファイル名を含む配列を取得します。 (継承元 FileDialog) |
| Filter |
OpenFileDialogまたはSaveFileDialogから表示されるファイルの種類を決定するフィルター文字列を取得または設定します。 (継承元 FileDialog) |
| FilterIndex |
ファイル ダイアログで現在選択されているフィルターのインデックスを取得または設定します。 (継承元 FileDialog) |
| InitialDirectory |
ファイル ダイアログで表示される初期ディレクトリを取得または設定します。 (継承元 FileDialog) |
| Multiselect |
ユーザーが複数のファイルを選択できるかどうかを示すオプション OpenFileDialog 取得または設定します。 |
| Options |
初期化のためにファイル ダイアログで使用される Win32 共通ファイル ダイアログ フラグを取得します。 (継承元 FileDialog) |
| ReadOnlyChecked |
OpenFileDialogによって表示される読み取り専用チェック ボックスが選択されているかどうかを示す値を取得または設定します。 |
| RestoreDirectory |
このプロパティは実装されていません。 (継承元 FileDialog) |
| SafeFileName |
選択したファイルのファイル名のみを含む文字列を取得します。 (継承元 FileDialog) |
| SafeFileNames |
選択したファイルごとに 1 つの安全なファイル名を含む配列を取得します。 (継承元 FileDialog) |
| ShowReadOnly |
OpenFileDialogに読み取り専用チェック ボックスが含まれているかどうかを示す値を取得または設定します。 |
| Tag |
ダイアログに関連付けられたオブジェクトを取得または設定します。 これにより、任意のオブジェクトをダイアログにアタッチできます。 (継承元 CommonDialog) |
| Title |
ファイル ダイアログのタイトル バーに表示されるテキストを取得または設定します。 (継承元 FileDialog) |
| ValidateNames |
ダイアログが有効な Win32 ファイル名のみを受け入れるかどうかを示す値を取得または設定します。 (継承元 FileDialog) |
メソッド
| 名前 | 説明 |
|---|---|
| CheckPermissionsToShowDialog() |
ダイアログを表示するための十分なアクセス許可が存在するかどうかを判断します。 (継承元 CommonDialog) |
| Equals(Object) |
指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
| GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| HookProc(IntPtr, Int32, IntPtr, IntPtr) |
ファイル ダイアログに共通機能を追加するためにオーバーライドされる共通ファイル ダイアログ フック プロシージャを定義します。 (継承元 FileDialog) |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| OnFileOk(CancelEventArgs) |
FileOk イベントを発生させます。 (継承元 FileDialog) |
| OpenFile() |
OpenFileDialogを使用してユーザーが選択したファイルの読み取り専用ストリームを開きます。 |
| OpenFiles() |
OpenFileDialogを使用してユーザーが選択したファイルごとに 1 つの読み取り専用ストリームを含む配列を作成します。 |
| Reset() |
すべての OpenFileDialog プロパティを既定値にリセットします。 |
| RunDialog(IntPtr) |
RunDialog(IntPtr) は、 OpenFileDialog や SaveFileDialogなどの派生クラスでファイル ダイアログを表示するために呼び出されます。 (継承元 FileDialog) |
| ShowDialog() |
共通ダイアログを表示します。 (継承元 CommonDialog) |
| ShowDialog(Window) |
共通ダイアログを表示します。 (継承元 CommonDialog) |
| ToString() |
ファイル ダイアログを表す文字列を返します。 (継承元 FileDialog) |
イベント
| 名前 | 説明 |
|---|---|
| FileOk |
ユーザーがの OpenFileDialog] ボタンまたはの SaveFileDialog] ボタンをクリックしてファイル名を選択したときに発生します。 (継承元 FileDialog) |