Boîte de dialogue Error

Une boîte de dialogue Error est une boîte de dialogue modale qui affiche un message d’erreur. Plusieurs boîtes de dialogue Error peuvent exister dans chaque installation.

Une propriété ErrorDialog doit être définie pour spécifier la boîte de dialogue à utiliser. Si cette propriété n’est pas définie ou ne pointe pas vers une boîte de dialogue Error valide, les messages d’erreur ne s’affichent pas. Dans ce cas, l’erreur est journalisée uniquement avec un avertissement concernant la boîte de dialogue manquante.

La boîte de dialogue Error doit avoir le bit de style Boîte de dialogue Error défini. La boîte de dialogue doit avoir un contrôle Text nommé ErrorText. L’enregistrement de la boîte de dialogue Error de la table Dialog doit avoir le contrôle ErrorText entré dans le champ Control_First.

La boîte de dialogue doit contenir sept PushButtons. Tous ces boutons spécifient le ControlEvent EndDialog dans la table ControlEvent. Chaque bouton spécifie un des attributs suivants : ErrorAbort, ErrorCancel, ErrorIgnore, ErrorNo, ErrorOk, ErrorRetry, ErrorYes.

Notes

Le focus de ces contrôles ne doit pas être lié à l’utilisation de la colonne Control_Next dans la table Control.

 

Ces boutons doivent être placés à peu près à la même position dans la boîte de dialogue, car pendant la création, seul un sous-ensemble de ces sept boutons est créé, en fonction du message. La coordonnée X des boutons est modifiée afin que les boutons affichés soient espacés uniformément. La coordonnée Y, la hauteur et la largeur des boutons ne changent pas. Comme les boutons sont disposés horizontalement, aucun autre contrôle ne peut être placé dans la même zone horizontale de la boîte de dialogue.

Pour une boîte de dialogue Error, les champs Control_Default et Control_Cancel de la table Dialog sont ignorés. Le champ Control_First d’une boîte de dialogue Error doit spécifier le contrôle ErrorText.

Si un contrôle Icon nommé ErrorIcon est inclus dans cette boîte de dialogue, les icônes Windows standard suivantes s’affichent :

• IDI_ERROR en réponse aux messages imtFatalExit.
• IDI_WARNING en réponse aux messages imtError et imtWarning.
• IDI_INFORMATION en réponse aux messages imtOutOfDiskSpace.

Le contrôle ErrorIcon doit être créé avec l’attribut de contrôle FixedSize défini pour éviter le dimensionnement incorrect des icônes Windows standard.