ダイアログ ボックス (Windows インストーラー)

ダイアログ ボックスは、Dialog テーブルの [ダイアログ] 列指定します。 ダイアログ ボックスまたはビルボードをユーザー インターフェイスに追加する方法の詳細については、「ユーザー インターフェイス の使用」を参照してください。

予約済みダイアログ ボックス名

次のダイアログ ボックス名は Windows インストーラーによって予約されており、ユーザーが作成したカスタム ダイアログ ボックスには使用しないでください。 インストーラーでは、次の予約名を使用して、これらのダイアログ ボックスを Dialog テーブル 一覧表示する必要があります。 各ダイアログ ボックスと名前は 1 回だけ表示できます。 開発者は、これらのダイアログ ボックスをユーザー インターフェイスに作成する必要があります。 ダイアログ ボックスをプレビューする方法については、「ユーザー インターフェイスのインポート」を参照してください。

ダイアログ ボックス名	ダイアログ ボックスの簡単な説明
FilesInUse ダイアログ	ファイルの上書きまたは削除を処理するようにユーザーに警告します。
FirstRun ダイアログ	ユーザー名、会社名、および製品 ID を収集します。
MsiRMFilesInUse ダイアログ	ファイルの上書きまたは削除を処理するようユーザーに警告し、再起動マネージャー を使用してアプリケーションを閉じて再起動するオプションをユーザーに提供します。

 

必須のダイアログ ボックス

インストール中に、特定のイベントにより、Windows インストーラーによって、パッケージに ユーザー インターフェイス シーケンス テーブルがチェックされ、指定されたダイアログ ボックスが表示されます。 たとえば、致命的なエラーが発生した場合、Windows インストーラーは、ダイアログ テーブルのの名前に関係なく、ユーザー インターフェイス シーケンス テーブルに -3 のシーケンス番号が表示されたダイアログ ボックスを表示します。 次の表に、ユーザー インターフェイス シーケンス テーブル内の特定のイベントとそれに対応するシーケンス番号を示します。

イベントの種類	ユーザー インターフェイス シーケンス テーブルのシーケンス番号	ダイアログ ボックスの説明
致命的なエラー	-3	致命的なエラーによってインストールが終了しました。
ユーザー終了	-2	インストールはユーザーの要求で終了しました。
Exit	-1	インストールが正常に完了しました。

 

さらに、パッケージ作成者は、Windows インストーラー エラー メッセージを表示する汎用ダイアログ ボックスを作成する必要があります。 このダイアログ ボックスには任意の名前を付けることができますが、この名前は ErrorDialog プロパティで指定する必要があります。

一般的なダイアログ ボックス

次のダイアログ ボックスは省略可能であり、通常はインストール パッケージの作成されたユーザー インターフェイスに含まれています。 これらのダイアログは、ファイルをインストールするために ほとんどのユーザー インターフェイス ウィザードの一般的なものです。 これらのダイアログ ボックスには、Dialog テーブル内の任意の名前を指定できます。 表示される名前は、わかりやすくするためにのみ推奨され、必要に応じて変更できます。 たとえば、2 つの異なるカスタム LicenseAgreement ダイアログ ボックスをパッケージで使用し、ダイアログ テーブルで ProfessionalLicenseAgreement と LimitedLicenseAgreement という名前で区別できます。

ダイアログ ボックスの種類	ダイアログ ボックスの簡単な説明
[DiskCost の ] ダイアログ ボックス	インストール用のディスク領域が不足していることを示します。
[参照] ダイアログ ボックス	ユーザーがディレクトリを選択できるようにします。
[キャンセル] ダイアログ ボックスの	インストールを終了する要求を確認します。
[使用許諾契約書の ] ダイアログ ボックス	使用許諾契約書を表示するモーダル ボックス。
[選択] ダイアログ ボックス	ユーザーが項目を選択できるようにするモーダル ボックス。