MessageBox

MessageBox gibt eine Messagebox (Meldungsfenster) aus. Es kann neben dem Meldungstext ein Titeltext sowie eine vordefinierte Kombination aus Symbolen (Icons) und Schaltflächen (push buttons) angegeben werden.

ssReturn = MessageBox(ssMessage)
ssReturn = MessageBox(ssMessage, svStyles)

Returnwert

ssReturn kann in Abhängigkeit vom Eingabeparameter svStyles einen der folgenden Werte annehmen:

Wert Bedeutung
„ABORT“ Die „Abbrechen“-Schaltfläche wurde gewählt.
„CANCEL“ Die „Abbrechen“-Schaltfläche wurde gewählt.
„IGNORE“ Die „Ignorieren“-Schaltfläche wurde gewählt.
„NO“ Die „Nein“-Schaltfläche wurde gewählt.
„OK“ Die „OK“-Schaltfläche wurde gewählt.
„RETRY“ Die „Wiederholen“-Schaltfläche wurde gewählt.
„YES“ Die „Ja“-Schaltfläche wurde gewählt.

Parameter

ssMessage

ssMessage ein skalarer String der den Meldungstext enthält. Der Text kann Zeilenumbrüche "\n" enthalten.

svStyles

svStyles ist ein Vektor mit einem oder mehreren der folgenden Strings:

Wert Bedeutung
„ABORTRETRYIGNORE“ Die MessageBox hat drei Schalter: „Abbrechen“, „Wiederholen“, „Ignorieren“.
„DEFBUTTON1“ Der erste Schalter ist der Default-Schalter.
„DEFBUTTON2“ Der zweite Schalter ist der Default-Schalter.
„DEFBUTTON3“ Der dritte Schalter ist der Default-Schalter.
„ICONASTERISK“ Das gleiche wie ICONINFORMATION.
„ICONEXCLAMATION“ Es wird ein gelbes Ausrufungszeichen als Icon verwendet.
„ICONHAND“ Es wird ein rotes Stop-Schild als Icon ausgegeben.
„ICONINFORMATION“ Es wird ein blauer Kreis mit einem weißen i als Icon verwendet.
„ICONQUESTION“ Es wird ein Fragezeichen als Icon ausgegeben.
„ICONSTOP“ Das gleiche wie ICONHAND.
„OK“ Die MessageBox hat den Schalter „OK“ (Default).
„OKCANCEL“ Die MessageBox hat die Schalter „OK“ und „Abbrechen“.
„RETRYCANCEL“ Die MessageBox hat die Schalter „Wiederholen“ und „Abbrechen“.
„YESNO“ Die MessageBox hat die Schalter „Ja“ und „Nein“.
„YESNOCANCEL“ Die MessageBox hat die Schalter „Ja“, „Nein“ und „Abbrechen“.

Beispiel

Der folgende Funktionsaufruf gibt ein Meldungsfeld aus

MessageBox("Dies ist die Meldung.", ..
          ["Dies ist der Titel", "ICONEXCLAMATION", "YESNOCANCEL"]);

id-1717671