Fehlerdialogfeld

Ein Fehlerdialogfeld ist ein modales Dialogfeld, in dem eine Fehlermeldung angezeigt wird. In jeder Installation können mehrere Fehlerdialogfeld vorhanden sein.

Eine ErrorDialog-Eigenschaft muss festgelegt werden, die angibt, welches Dialogfeld verwendet werden soll. Wenn diese Eigenschaft nicht festgelegt ist oder nicht auf ein gültiges Fehlerdialogfeld zeigt, werden die Fehlermeldungen nicht angezeigt. In diesem Fall wird der Fehler nur mit einer Warnung über das fehlende Dialogfeld protokolliert.

Für ein Dialogfeld "Fehler" muss die Fehlerdialogformatvorlage bit festgelegt sein. Das Dialogfeld muss über ein Textsteuerelement "ErrorText" verfügen. Der Datensatz für das Dialogfeld "Fehler" in der Dialogtabelle muss das ErrorText-Steuerelement in das Feld Control_First eingegeben haben.

Das Dialogfeld muss sieben PushButtonsenthalten. Alle diese Schaltflächen geben das EndDialog ControlEvent in der ControlEvent-Tabellean. Jede Schaltfläche gibt eines der folgenden Attribute an: ErrorAbort, ErrorCancel, ErrorIgnore, ErrorNo, ErrorOk, ErrorRetry, ErrorYes.

Anmerkung

Der Fokus dieser Steuerelemente sollte nicht über die Verwendung der Control_Next Spalte in der Steuerelementtabelleverknüpft werden.

 

Diese Schaltflächen sollten in etwa der gleichen Position im Dialogfeld platziert werden, da bei der Erstellung nur eine Teilmenge dieser sieben Schaltflächen je nach Nachricht erstellt wird. Die X-Koordinate der Schaltflächen wird so geändert, dass die angezeigten Schaltflächen gleichmäßig angeordnet sind. Die Y-Koordinate, Höhe und Breite der Schaltflächen sind unverändert. Da die Schaltflächen horizontal angeordnet sind, kann kein anderes Steuerelement im gleichen horizontalen Bereich des Dialogfelds platziert werden.

Bei einem Fehlerdialogfeld werden die Felder Control_Default und Control_Cancel in der Dialogtabelle ignoriert. Das feld Control_First für ein Fehlerdialogfeld muss das ErrorText-Steuerelement angeben.

Wenn in diesem Dialogfeld ein Symbolsteuerelement "ErrorIcon" enthalten ist, werden die folgenden Windows-Standardsymbole angezeigt:

• IDI_ERROR als Reaktion auf imtFatalExit-Nachrichten.
• IDI_WARNING als Reaktion auf imtError- und imtWarning-Nachrichten.
• IDI_INFORMATION als Reaktion auf imtOutOfDiskSpace-Nachrichten.

Das ErrorIcon-Steuerelement sollte mit dem FixedSize-Steuerelement-Attribut erstellt werden, festgelegt werden, um die falsche Größenanpassung der Standardmäßigen Windows-Symbole zu vermeiden.