Error-Dialogfeld
Bei einem Error-Dialogfeld handelt es sich um ein modales Dialogfeld, in dem eine Fehlermeldung angezeigt wird. In jeder Installation können mehrere Error-Dialogfelder vorhanden sein.
Es muss eine ErrorDialog-Eigenschaft festgelegt werden, die angibt, welches Dialogfeld verwendet werden soll. Wenn diese Eigenschaft nicht festgelegt ist oder nicht auf ein gültiges Error-Dialogfeld verweist, werden die Fehlermeldungen nicht angezeigt. In diesem Fall wird der Fehler nur mit einer Warnung zum fehlenden Dialogfeld protokolliert.
Für ein Error-Dialogfeld muss das Stilbit Error-Dialog festgelegt sein. Das Dialogfeld muss über ein Text-Steuerelement namens ErrorText verfügen. Im Datensatz für das Error-Dialogfeld in der Dialog-Tabelle muss das ErrorText-Steuerelement in das Feld Control_First eingegeben werden.
Das Dialogfeld muss sieben PushButtons enthalten. Alle diese Schaltflächen geben das EndDialog-ControlEvent in der ControlEvent-Tabelle an. Jede Schaltfläche gibt eines der folgenden Attribute an: ErrorAbort, ErrorCancel, ErrorIgnore, ErrorNo, ErrorOk, ErrorRetry, ErrorYes.
Hinweis
Der Fokus dieser Steuerelemente sollte nicht durch Verwenden der Spalte Control_Next in der Control-Tabelle verknüpft werden.
Diese Schaltflächen sollten ungefähr an der gleichen Position im Dialogfeld platziert werden, da beim Erstellen je nach Meldung nur eine Teilmenge dieser sieben Schaltflächen erstellt wird. Die X-Koordinate der Schaltflächen wird geändert, sodass die angezeigten Schaltflächen einen gleichmäßigen Abstand aufweisen. Die Y-Koordinate, Höhe und Breite der Schaltflächen bleiben unverändert. Da die Schaltflächen horizontal angeordnet sind, kann kein anderes Steuerelement im gleichen horizontalen Bereich des Dialogfelds platziert werden.
Bei einem Error-Dialogfeld werden die Felder Control_Default und Control_Cancel in der Dialog-Tabelle ignoriert. Für ein Error-Dialogfeld muss das ErrorText-Steuerelement durch das Feld Control_First angegeben werden.
Wenn in diesem Dialogfeld ein Symbolsteuerelement mit dem Namen 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-Steuerelementattribut erstellt werden, um eine falsche Größenanpassung der Windows-Standardsymbole zu vermeiden.