Error ダイアログ

Error ダイアログ ボックスは、エラー メッセージを表示するモーダル ダイアログ ボックスです。 1 つのインストールに複数の Error ダイアログ ボックスが存在する場合があります。

使用するダイアログ ボックスを指定する ErrorDialog プロパティを設定する必要があります。 このプロパティが設定されていない場合、または有効な Error ダイアログ ボックスを指していない場合、エラー メッセージは表示されません。 この場合、エラーは、ダイアログ ボックスがないことに関する警告と共にのみログされます。

Error ダイアログ ボックスには、Error ダイアログ スタイル ビットが設定されている必要があります。 このダイアログ ボックスには、ErrorText という名前の Text コントロールが必要です。 Dialog テーブルの Error ダイアログ ボックスのレコードでは、Control_First フィールドに ErrorText コントロールを入力する必要があります。

このダイアログ ボックスには、7 つの PushButton が含まれている必要があります。 これらのボタンはすべて、ControlEvent テーブルの EndDialog ControlEvent を指定します。 各ボタンは、ErrorAbort、ErrorCancel、ErrorIgnore、ErrorNo、ErrorOk、ErrorRetry、ErrorYes のいずれかの属性を指定します。

Note

これらのコントロールのフォーカスは、Control テーブルの Control_Next 列を使用してリンクしないでください。

 

これらのボタンは、ダイアログ ボックス内のほぼ同じ位置に配置する必要があります。ボタンの作成時、メッセージに応じてこれら 7 つのボタンの一部のみが作成されるためです。 ボタンの X 座標が変更され、表示されるボタンが均等に配置されます。 ボタンの Y 座標、高さ、幅は変更されません。 ボタンは水平方向に配置されるため、ダイアログ ボックスの同じ水平方向の領域に他のコントロールを配置できません。

Error ダイアログ ボックスでは、Dialog テーブルの Control_Default および Control_Cancel フィールドは無視されます。 Error ダイアログ ボックスの Control_First フィールドは、ErrorText コントロールを指定している必要があります。

このダイアログに ErrorIcon という名前の Icon コントロールが含まれている場合は、次の標準 Windows アイコンが表示されます。

• imtFatalExit メッセージに応答する IDI_ERROR。
• imtError および imtWarning メッセージに応答する IDI_WARNING。
• imtOutOfDiskSpace メッセージに応答する IDI_INFORMATION。

標準の Windows アイコンのサイズが不適切にならないように、FixedSize コントロール属性を設定して ErrorIcon コントロールを作成する必要があります。