Funktionsreferenz

MsgBox

Zeigt eine einfache MessageBox mit optionaler Zeitbegrenzung an.

MsgBox ( flag, "title", "text" [, timeout [, hwnd]] )

 

Parameter

flag Das Flag gibt an, wie die Box aussieht, und welche Buttons angezeigt werden. Siehe Bemerkungen.
title Der Titel der MessageBox.
text Der Text der MessageBox.
timeout [optional] Zeitbegrenzung in Sekunden. Danach wird die MessageBox automatisch geschlossen. Der Standard ist 0 welches keiner Zeitunterbrechung entspricht.
hwnd [optional] Das Fenster Handle welches als Parent für diesen Dialog verwendet werden soll.

 

Rückgabewert

Erfolg: Gibt die ID des gedrückten Buttons zurück.
Fehler: Gibt -1 zurück, wenn die Messagebox nach Zeitüberschreitung automatisch geschlossen wurde.
Gedrückter Button Rückgabewert
OK  1 (gültig für Flag 0, 1)
ABBRECHEN  2 (gültig für Flag 1, 3, 5, 6)
ABBRECHEN  3 (gültig für Flag 2)
WIEDERHOLEN  4 (gültig für Flag 2, 5)
IGNORIEREN  5 (gültig für Flag 2)
JA  6 (gültig für Flag 3, 4)
NEIN  7 (gültig für Flag 3, 4)
WIEDERHOLEN ** 10 (gültig für Flag 6)
WEITER ** 11 (gültig für Flag 6)

 

Bemerkungen

Der Flag Parameter kann eine Kombination der fogenden Werte sein:

Flag (dezimal) Resultierende(r) Button(s) Flag (hexadezimal)
0 OK 0x0
1 OK und Abbrechen 0x1
2 Abbrechen, Wiederholen und Ignorieren 0x2
3 Ja, Nein, und Abbrechen 0x3
4 Ja und Nein 0x4
5 Wiederholen und Abbrechen 0x5
6 ** Abbrechen, Wiederholen, Weiter 0x6
Flag (dezimal) Resultierendes Icon Flag (hexadezimal)
0 (Kein Icon) 0x0
16 Stopp-Zeichen 0x10
32 Fragezeichen 0x20
48 Ausrufezeichen 0x30
64 Information (bestehend aus einem "i" in einem Kreis 0x40
Flag (dezimal) Resultierender Standardbutton Flag (hexadezimal)
0 Erster Button ist der Standardbutton 0x0
256 Zweiter Button ist der Standardbutton 0x100
512 Dritter Button ist der Standardbutton 0x200
Flag (dezimal) Resultierende Modalität Flag (hexadezimal)
0 Anwendung 0x0
4096 System-modal (Dialog hat ein Icon) 0x1000
8192 Task-modal 0x2000
Flag (dezimal) Sonstiges Ergebnis Flag (hexadezimal)
0 (nichts weiteres) 0x0
262144 MsgBox ist immer im Vordergrund 0x40000
524288 Titel und Text sind rechtsbündig angeordnet 0x80000

** nur gültig auf Windows 2000/XP und höher.

Ein Beispiel: Will man eine MessageBox mit dem Attribut SYSTEMMODAL und JA-/NEIN-Button, so wäre der Flag-Wert 4096+4 (oder 4100). Oder hexadezimal: 0x1000+0x4 (oder 0x1004).

Eine MessageBox erscheint zentriert auf dem Bildschirm und verändert ihre Größe nach der Länge des anzuzeigenden Textes. Trotzdem kann der Titel abgeschnitten werden, wenn das Attribut SYSTEMMODAL (4096) gesetzt wird.

Wenn der Titel gleich mit dem Schlüsselwort Default ist, wird @Scriptname verwendet

 

Verwandte Funktionen

InputBox, ToolTip, TrayTip, SplashTextOn

 

Beispiel


MsgBox(4096, "Test", "Diese Box wird sich in 10 Sekunden selbst schließen", 10)