FileDialog インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Microsoft Office アプリケーションでファイルを開いたり保存する標準的な [ファイルを開く] および [保存] ダイアログ ボックスに類似するファイル ダイアログ ボックスの機能を提供します。
public interface class FileDialog : Microsoft::Office::Core::_IMsoDispObj
[System.Runtime.InteropServices.Guid("000C0362-0000-0000-C000-000000000046")]
public interface FileDialog : Microsoft.Office.Core._IMsoDispObj
[<System.Runtime.InteropServices.Guid("000C0362-0000-0000-C000-000000000046")>]
type FileDialog = interface
interface _IMsoDispObj
Public Interface FileDialog
Implements _IMsoDispObj
- 属性
- 実装
注釈
このオブジェクトが提供するダイアログ ボックスを使用すると、ソリューションのユーザーは、ソリューションで使用するファイルとフォルダーを簡単に指定できます。
FileDialog プロパティを使用して FileDialog オブジェクトを返します。
FileDialog プロパティは、各 Office アプリケーションの Application オブジェクトにあります。 プロパティは、プロパティから返される FileDialog オブジェクトの種類を決定する、DialogType 1 つの引数を受け取ります。
FileDialog オブジェクトには、次の 4 種類があります。
[開く] ダイアログ ボックス - Execute メソッドを 使用してホスト アプリケーションで開くことができる 1 つ以上のファイルをユーザーが選択できるようにします。
[SaveAs] ダイアログ ボックス - ユーザーが 1 つのファイルを選択し、 Execute メソッドを使用して現在のファイルを保存できます。
[ファイル ピッカー] ダイアログ ボックス - ユーザーが 1 つ以上のファイルを選択できるようにします。 ユーザーが選択したファイル パスは、 FileDialogSelectedItems コレクションにキャプチャされます。
[フォルダー ピッカー] ダイアログ ボックス - ユーザーがパスを選択できるようにします。 ユーザーが選択するパスは、FileDialogSelectedItems コレクションにキャプチャされます。
各ホスト アプリケーションは、 FileDialog オブジェクトの 1 つのインスタンスのみをインスタンス化できます。 そのため、複数の FileDialog オブジェクトを作成した場合でも、FileDialog オブジェクトのプロパティの多くは保持されます。 そのため、ダイアログ ボックスを表示する前に、目的に合わせてすべてのプロパティを適切に設定していることを確認してください。
FileDialog オブジェクトを使用してファイル ダイアログ ボックスを表示するには、Show() メソッドを使用する必要があります。 ダイアログ ボックスが表示されると、ユーザーがダイアログ ボックスを閉じるまでコードは実行されません。
プロパティ
| 名前 | 説明 |
|---|---|
| AllowMultiSelect |
ユーザーがファイル ダイアログ ボックスから複数のファイルを選択できるかどうかを判断します。 |
| Application |
オブジェクトのコンテナー アプリケーションを表す Application オブジェクトを返します。 |
| ButtonName |
ファイル ダイアログ ボックスのアクション ボタンに表示されるテキストを表す文字列型 ( String) の値を取得または設定します。 |
| Creator |
指定されたオブジェクトを作成したアプリケーションを示す 32 ビットの整数を取得します。 |
| DialogType |
FileDialog オブジェクトが表示するように設定されているファイル ダイアログ ボックスの種類を表すMsoFileDialogType定数を返します。 |
| FilterIndex |
ファイル ダイアログ ボックスの既定のファイル フィルターを示す整数型 ( Integer) の値を設定または返します。 |
| Filters |
FileDialogFilters コレクションを返します。 |
| InitialFileName |
ファイル ダイアログ ボックスに最初に表示されるパスまたはファイル名を表す文字列型 ( String) の値を取得または設定します。 |
| InitialView |
ファイル ダイアログ ボックス内のファイルとフォルダーの初期プレゼンテーションを表す MsoFileDialogView 定数を設定または返します。 |
| Item |
オブジェクトに関連付けられているテキストを返します。 |
| Parent |
指定したオブジェクトの Parent オブジェクトを返します。 |
| SelectedItems |
FileDialogSelectedItems コレクションを返します。 |
| Title |
FileDialog オブジェクトを使用して表示されるファイル ダイアログ ボックスのタイトルを設定または返します。 |
メソッド
| 名前 | 説明 |
|---|---|
| Execute() |
指定したコマンド バー コントロールに割り当てられたプロシージャまたは組み込みコマンドを実行します。 |
| Show() |
ファイル ダイアログ ボックスを表示し、ユーザーがアクション ボタン (-1) またはキャンセル ボタン (0) を押したかどうかを示す 整数型 (Integer ) を返します。 |