Freigeben über


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.