MsgBox

Zeigt einen bestimmten Text in einem kleinen Fenster an, das eine oder mehrere Schaltflächen enthält (z.B. Ja und Nein).

MsgBox Text, Titel, Optionen
Ergebnis := MsgBox(Text, Titel, Optionen)

Parameter

Text

Typ: Zeichenkette

Wenn weggelassen und "OK" die einzige Schaltfläche ist, wird standardmäßig die Zeichenkette "Press OK to continue." verwendet. Wenn in jedem anderen Fall weggelassen, wird standardmäßig eine leere Zeichenkette verwendet. Andernfalls geben Sie den Text an, der im Mitteilungsfenster angezeigt werden soll.

Mit Escapesequenzen können Sonderzeichen dargestellt werden. Zum Beispiel kann mit `n (LF-Zeichen) die aktuelle Zeile beendet und eine neue begonnen werden. Entsprechend würde Text1`n`nText2 eine Leerzeile zwischen Text1 und Text2 erzeugen.

Wenn Text relativ lang ist, kann es via Fortsetzungsbereich in mehrere kurze Zeilen aufgeteilt werden, um die Übersichtlichkeit und Wartbarkeit des Skripts zu verbessern.

Titel

Typ: Zeichenkette

Wenn weggelassen, wird standardmäßig der aktuelle Wert von A_ScriptName verwendet. Andernfalls geben Sie den Titel des Mitteilungsfensters an.

Optionen

Typ: Zeichenkette

Wenn leer oder weggelassen, wird standardmäßig 0 verwendet (nur eine OK-Schaltfläche anzeigen). Andernfalls geben Sie eine Kombination (Summe) von Werten oder eine Zeichenkette von einer oder mehreren Optionen aus den unteren Tabellen an, um den Typ des Mitteilungsfensters und die möglichen Schaltflächenkombinationen zu bestimmen.

Zusätzlich können beliebig viele der folgenden Optionen angegeben werden:

Owner: Um ein übergeordnetes Fenster für das Mitteilungsfenster zu bestimmen, verwenden Sie das Wort Owner gefolgt von einer HWND-Nummer (eindeutige ID).

T: Timeout (Zeitlimit). Um das Mitteilungsfenster automatisch zu schließen, wenn der Benutzer es nicht innerhalb einer bestimmten Zeit geschlossen hat, verwenden Sie den Buchstaben T gefolgt von einem Zeitlimit in Sekunden, das einen Dezimalpunkt enthalten kann. Wenn ein Zeitlimit höher als 2147483 (24,8 Tage) angegeben ist, wird es automatisch auf 2147483 zurückgesetzt. Wenn das Mitteilungsfenster das Zeitlimit überschreitet, ist der Rückgabewert das Wort Timeout.

Werte für den Optionen-Parameter

Der Optionen-Parameter kann entweder eine Kombination (Summe) von Werten aus den folgenden Gruppen sein, die direkt an die MessageBox-Funktion des Betriebssystems übergeben wird, oder eine Zeichenkette von beliebig vielen Optionen (nicht Groß-/Kleinschreibung-sensitiv), die mit mindestens einem Leer- oder Tabulatorzeichen voneinander getrennt sind. Die Zeichenkette kann auch beliebig viele numerische Optionen enthalten.

Gruppe #1: Schaltflächen

Um zu bestimmen, welche Schaltflächen im Mitteilungsfenster angezeigt werden, addieren Sie einen der folgenden Werte:

Gruppe #2: Symbol

Um ein Symbol im Mitteilungsfenster darzustellen, addieren Sie einen der folgenden Werte:

Gruppe #3: Standardschaltfläche

Um die Standardschaltfläche zu bestimmen, addieren Sie einen der folgenden Werte:

Gruppe #4: Modalität

Um die Modalität des Dialogfensters zu bestimmen, addieren Sie einen der folgenden Werte:

Gruppe #5: Sonstige Optionen

Um sonstige Optionen anzugeben, addieren Sie einen oder mehrere der folgenden Werte:

Rückgabewert

Typ: Zeichenkette

Diese Funktion gibt eine der folgenden Zeichenketten zurück, die die zuletzt gedrückte Schaltfläche repräsentiert:

• OK
• Cancel
• Yes
• No
• Abort
• Retry
• Ignore
• TryAgain
• Continue
• Timeout (wenn MsgBox das Zeitlimit überschreitet)

Wenn das Dialogfenster nicht angezeigt werden konnte, wird eine leere Zeichenkette zurückgegeben. Dies tritt normalerweise nur auf, wenn das MsgBox-Limit erreicht wurde, kann aber auch in anderen Ausnahmefällen auftreten.

Fehlerbehandlung

Bei Misserfolg wird ein Error ausgelöst, z.B. wenn die Optionen ungültig sind, das MsgBox-Limit erreicht wurde oder das Mitteilungsfenster aus anderen Gründen nicht angezeigt werden konnte.

Bemerkungen

Ein typisches Mitteilungsfenster sieht wie folgt aus:

Verwenden Sie den Rückgabewert der Funktion, um festzustellen, welche Schaltfläche der Benutzer gedrückt hat. Zum Beispiel:

Ergebnis := MsgBox("Möchten Sie fortfahren? (drücken Sie Ja oder Nein)",, "YesNo")
if Ergebnis = "Yes"
    MsgBox "Sie haben Ja gedrückt."
else
    MsgBox "Sie haben Nein gedrückt."

if MsgBox("Wiederholen oder Abbrechen?",, "R/C") = "Retry"
    MsgBox("Sie haben Wiederholen gedrückt.")

Um die Namen der Schaltflächen anzupassen, siehe Schaltflächennamen der MsgBox ändern.

Hinweis: Sie können Strg+C in einem aktiven Mitteilungsfenster drücken, um dessen Text in die Zwischenablage zu kopieren. Diese Methode kann auch bei AutoHotkey-fremden Mitteilungsfenstern angewendet werden.

MsgBox mit einem GUI-Fenster verwenden: Ein GUI-Fenster kann ein modales Mitteilungsfenster mittels OwnDialogs-Option darstellen. Ein modales Mitteilungsfenster hindert den Benutzer daran, mit dem GUI-Fenster zu interagieren, bis er das Mitteilungsfenster wieder schließt. In diesem Fall können die Optionen System-Modal oder Task-Modal weggelassen werden.

Wenn die OwnDialogs-Option nicht aktiv ist, kann die Task-Modal-Option (8192) verwendet werden, um die Interaktion mit allen Skriptfenstern zu unterbinden, bis der Benutzer das Mitteilungsfenster schließt.

Wenn die OwnerHWND-Option angegeben ist, hat sie Vorrang vor allen anderen Einstellungen. HWND kann die HWND-Nummer (eindeutige ID) eines beliebigen Fensters sein, auch eines Fensters, das nicht zum Skript gehört.

Die Hilfe-Schaltfläche: Wenn die Hilfe-Schaltfläche-Option (16384) in Optionen vorhanden ist, funktioniert die Hilfe-Schaltfläche nur unter den folgenden Bedingungen:

1. Das Mitteilungsfenster wurde einem GUI-Fenster mittels OwnDialogs-Option untergeordnet.
2. Das Skript überwacht die WM_HELP-Meldung (0x0053). Zum Beispiel: OnMessage(0x0053, WM_HELP). Dies bewirkt, dass die WM_HELP-Funktion aufgerufen wird, sobald der Benutzer die Hilfe-Schaltfläche drückt. Diese Funktion könnte z.B. ein anderes GUI-Fenster oder Mitteilungsfenster anzeigen, das Hilfestellungen für den Benutzer enthält.

Die Schließen-Schaltfläche (in der Titelleiste des Mitteilungsfensters): Da das Mitteilungsfenster ein vom Betriebssystem bereitgestelltes Feature ist, hängt die Verfügbarkeit und das Verhalten der X-Schaltfläche davon ab, welche Schaltflächen vorhanden sind. Wenn nur die OK-Schaltfläche vorhanden ist, wäre das Drücken von X das gleiche wie, als hätte man OK gedrückt. Andernfalls ist die X-Schaltfläche deaktiviert, es sei denn, die Abbrechen-Schaltfläche ist vorhanden, dann wäre das Drücken von X das gleiche wie, als hätte man Abbrechen gedrückt.

Maximal 7 aktive Aufrufe: Der Thread, der ein Mitteilungsfenster anzeigt, kann normalerweise unterbrochen werden, damit der neue Thread sein eigenes Mitteilungsfenster anzeigen kann, bevor der vorherige Aufruf zurückkehrt. Es sind maximal 7 aktive MsgBox-Aufrufe erlaubt. Jeder Aufruf nach dem siebten löst einen Error aus. Beachten Sie, dass ein MsgBox-Aufruf in einem unterbrochenen Thread nicht zum Aufrufer zurückkehrt, bis der Thread fortgesetzt wird.

Siehe auch

InputBox, FileSelect, DirSelect, ToolTip, Gui-Objekt

Beispiele

MsgBox "Das ist eine Zeichenkette."

MsgBox "Diese MsgBox hat einen benutzerdefinierten Titel.", "Ein benutzerdefinierter Titel"

MsgBox ; "Press OK to continue."

MsgBox "
  (
    Der erste Parameter wird als Mitteilung angezeigt.
    Der zweite Parameter ist der Fenstertitel.
    Der dritte Parameter bestimmt den Typ des Mitteilungsfensters.
  )", "Fenstertitel", "iconi"

Ergebnis := MsgBox("Möchten Sie fortfahren? (drücken Sie Ja oder Nein)",, "YesNo")
if (Ergebnis = "No")
    return

Ergebnis := MsgBox("Diese MsgBox schließt sich automatisch in 5 Sekunden.  Weiter?",, "Y/N T5")
if (Ergebnis = "Timeout")
    MsgBox "Sie haben innerhalb der 5 Sekunden weder JA noch NEIN gedrückt."
else if (Ergebnis = "No")
    return

var := 10
MsgBox "Der Initialwert ist: " var
MsgBox "Das Ergebnis ist: " var * 2
MsgBox Format("Das Ergebnis ist: {1}", var * 2)