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

  • [アーティクル]

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

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

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

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

 

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

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

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

 

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

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

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

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