ConfirmBox()

Allgemeines

Die Funktion ConfirmBox() ist ein Wrapper für einen Standard-Windows-Dialog, der mit einigen vordefinierten Icons und Buttons konfiguriert werden kann. Die Funktion eignet sich für Ad-hoc-Abfragen im Rahmen eines Programmes.

Syntax

ConfirmBox([<oOwner>], <cNachricht>, [<cTitel>], [<nButtons>], [<nIcon>], [<nStartButton>]) => [nAnswer]

Parameter

<oOwner> definiert den Owner der ConfirmBox(). Ist dieser Parameter nicht angegeben, wird der Rückgabewert von SetAppWindow() verwendet.

<cNachricht> ist ein String, der als Nachricht in der ConfirmBox() angezeigt werden soll.

<cTitel> ist ein optionaler String, der in der Titlebar des Fensters angezeigt wird.

<nButtons> ist ein optionaler Wert, der angibt, welche Button-Kombination angezeigt werden soll. Möglich sind die folgenden Werte:

XBPMB_OK	OK
XBPMB_OKCANCEL	OK und CANCEL
XBPMB_RETRYCANCEL	RETRY und CANCEL
XBPMB_ABORTRETRYIGNORE	ABORT, RETRY und IGNORE
XBPMB_YESNO	YES und NO
XBPMB_YESNOCANCEL	YES, NO und CANCEL

<nIcon> ist ein optionaler Parameter, mittels dem ein vordefiniertes Icon linksbündig in der ConfirmBox() dargestellt werden kann.

XBPMB_NOICON	es wird kein Icon dargestellt (Unterlassungswert)
XBPMB_QUESTION	Fragezeichen
XBPMB_WARNING	Warnung
XBPMB_INFORMATION	Informationeller Hinweis
XBPMB_CRITICAL	kritische Situation

<nStartButton> gibt an, welcher Button voreingestellt sein soll.

Rückgabewert

nAnswer gibt an, welche Aktion der Benutzer ausgeführt hat. Es gibt die folgenden Möglichkeiten: