.. highlightlang:: us

.. index:: MessageBox

.. _messagebox:

MessageBox
==========

.. us.tag  MessageBox GERMAN DialogBoxes

:ref:`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.

.. function::  ssReturn = MessageBox(ssMessage)
    ssReturn = MessageBox(ssMessage, svStyles)

.. us.return

**Returnwert**

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

.. list-table::
   :header-rows: 1

   * - 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.

.. us.params

**Parameter**

.. uparam:: ssMessage

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

.. uparam:: svStyles

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

   .. list-table::
      :header-rows: 1

      * - 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".

.. us.example

**Beispiel**

Der folgende Funktionsaufruf gibt ein Meldungsfeld aus

::

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

.. seealso::
   :ref:`uberblick-dialogboxen`,
   :ref:`DialogBox`

:sub:`id-1717671`