MsgBox
Beschreibung anzeigen in
Zeigt eine einfache MessageBox mit optionaler Zeitbegrenzung an.
MsgBox ( flag, "title", "text" [, timeout = 0 [, 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: | Die ID des gedrückten Buttons. |
| Fehler: | $IDTIMEOUT (-1) wenn die Messagebox nach Zeitüberschreitung automatisch geschlossen wurde. |
| Gedrückter Button | Rückgabewert |
| OK | $IDOK (1) (gültig für Flag 0, 1) |
| ABBRECHEN | $IDCANCEL (2) (gültig für Flag 1, 3, 5, 6) |
| ABBRECHEN | $IDABORT (3) (gültig für Flag 2) |
| WIEDERHOLEN | $IDRETRY (4) (gültig für Flag 2, 5) |
| IGNORIEREN | $IDIGNORE (5) (gültig für Flag 2) |
| JA | $IDYES (6) (gültig für Flag 3, 4) |
| NEIN | $IDNO (7) (gültig für Flag 3, 4) |
| WIEDERHOLEN | $IDTRYAGAIN (10) (gültig für Flag 6) |
| WEITER | $IDCONTINUE (11) (gültig für Flag 6) |
Die Konstanten sind in MsgBoxConstants.au3 definiert.
Bemerkungen
Der Flag Parameter kann eine Kombination der folgenden Werte sein:
| Konstante | Flag (dezimal) | Resultierende(r) Button(s) | Flag (hexadezimal) |
|---|---|---|---|
| $MB_OK | 0 | OK | 0x0 |
| $MB_OKCANCEL | 1 | OK und Abbrechen | 0x1 |
| $MB_ABORTRETRYIGNORE | 2 | Abbrechen, Wiederholen und Ignorieren | 0x2 |
| $MB_YESNOCANCEL | 3 | Ja, Nein, und Abbrechen | 0x3 |
| $MB_YESNO | 4 | Ja und Nein | 0x4 |
| $MB_RETRYCANCEL | 5 | Wiederholen und Abbrechen | 0x5 |
| $MB_CANCELTRYCONTINUE | 6 | Abbrechen, Wiederholen, Weiter | 0x6 |
| $MB_HELP | 16384 | Hilfe-Button wird zur Messagebox hinzugefügt. Wird der Hilfe-Button oder F1 gedrückt, so wird dem Besitzer eine WM_HELP Meldung gesendet. | 0x4000 |
| Konstante | Flag (dezimal) | Resultierendes Icon | Flag (hexadezimal) |
| $MB_ICONNONE | 0 | (Kein Icon) | 0x0 |
| $MB_ICONERROR | 16 | Stopp-Zeichen | 0x10 |
| $MB_ICONQUESTION | 32 | Fragezeichen | 0x20 |
| $MB_ICONWARNING | 48 | Ausrufezeichen | 0x30 |
| $MB_ICONINFORMATION | 64 | Information (bestehend aus einem "i" in einem Kreis) | 0x40 |
| Konstante | Flag (dezimal) | Resultierender Standardbutton | Flag (hexadezimal) |
| $MB_DEFBUTTON1 | 0 | Erster Button ist der Standardbutton | 0x0 |
| $MB_DEFBUTTON2 | 256 | Zweiter Button ist der Standardbutton | 0x100 |
| $MB_DEFBUTTON3 | 512 | Dritter Button ist der Standardbutton | 0x200 |
| $MB_DEFBUTTON4 | 768 | Vierter Button ist der Standardbutton | 0x300 |
| Konstante | Flag (dezimal) | Resultierende Modalität | Flag (hexadezimal) |
| $MB_APPLMODAL | 0 | Anwendung | 0x0 |
| $MB_SYSTEMMODAL | 4096 | System-modal (Dialog hat ein Icon) | 0x1000 |
| $MB_TASKMODAL | 8192 | Task-modal | 0x2000 |
| Konstante | Flag (dezimal) | Sonstiges Ergebnis | Flag (hexadezimal) |
| 0 | (nichts weiteres) | 0x0 | |
| $MB_DEFAULT_DESKTOP_ONLY | 131072 | MsgBox() wird am Default-Desktop der interaktiven window station angezeigt. | 0x20000 |
| $MB_RIGHT | 524288 | Titel und Text sind rechtsbündig angeordnet | 0x80000 |
| $MB_RTLREADING | 1048576 | Titel und Text werden, auf hebräisch und arabischen Systemen, in rechts nach links Leserichtung angezeigt. | 0x100000 |
| $MB_SETFOREGROUND | 65536 | Die Messagebox wird das oberste Fenster. | 0x10000 |
| $MB_TOPMOST | 262144 | MsgBox() wird immer im Vordergrund angezeigt (Attribut 'top-most' gesetzt) | 0x40000 |
| $MB_SERVICE_NOTIFICATION | 2097152 | Es wird eine Messagebox auf dem aktuell aktivem Desktop angezeigt, auch wenn kein Benutzer am Rechner eingeloggt ist. | 0x200000 |
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
Hinweis: MsgBox unterstützt die Verwendung des timeout Parameters nicht, wenn das $MB_SERVICE_NOTIFICATION Flag verwendet wird. Dies passiert, wenn MsgBox von einem Service aufgerufen wird. Das Nachrichtenfenster gehört nicht zum Prozess, wenn MsgBox aufgerufen wird und $MB_SERVICE_NOTIFICATION verwendet wird.
Die Konstanten sind in MsgBoxConstants.au3 definiert.
Verwandte Funktionen
InputBox, SplashTextOn, ToolTip, TrayTip