|
Microsoft® Visual Basic® Scripting Edition MsgBox-Funktion |
Sprachreferenz |
Zeigt eine Meldung in einem Dialogfeld an, wartet darauf, daß der Benutzer eine Schaltfläche wählt, und gibt einen Wert zurück, der anzeigt, welche Schaltfläche gewählt wurde.
MsgBox(Eingabeaufforderung[, Schaltflächen][, Titel][, Hilfedatei, Kontext])
Die Syntax der MsgBox-Funktion besteht aus folgenden Teilen:
Teil Beschreibung Eingabeaufforderung Zeichenfolgenausdruck, der als Meldung im Dialogfeld angezeigt werden soll. Die maximale Länge der Eingabeaufforderung ist etwa 1024 Zeichen, je nach Breite der verwendeten Zeichen. Wenn die Eingabeaufforderung mehr als eine Zeile umfaßt, können Sie zwei Zeilen jeweils mit einem Wagenrücklaufzeichen (Chr(13)), einem Zeilenvorschubzeichen (Chr(10)) oder einer Kombination von Wagenrücklauf- und Zeilenvorschubzeichen (Chr(13)& Chr(10)) trennen. Schaltflächen Numerischer Ausdruck, der die Summe der Werte für folgende Angaben darstellt: Anzahl und Art der anzuzeigenden Schaltflächen, Art des zu verwendenden Symbols, Kennzeichnung der Standardschaltfläche und Verhalten des Meldungsfelds (gebunden/ungebunden). Betrachten Sie den Abschnitt Einstellungen für die Werte. Falls nichts angegeben wird, ist der Standardwert für Schaltflächen 0. title Zeichenfolgenausdruck, der in der Titelleiste des Dialogfelds angezeigt wird. Wenn Sie Titel nicht angeben, wird der Name der Anwendung in der Titelleiste angezeigt. Hilfedatei Zeichenfolgenausdruck, der die Hilfedatei angibt, die für die kontextbezogene Hilfe zum Dialogfeld geöffnet wird. Wenn Hilfedatei angegeben wird, muß Kontext ebenfalls angegeben werden. Nicht verfügbar auf 16-Bit Systemen. Kontext Numerischer Ausdruck, der die Hilfe-Kontextnummer angibt, die der Hilfe-Autor dem zugehörigen Hilfethema zugeordnet hat. Wenn Kontext angegeben wird, muß Hilfedatei ebenfalls angegeben werden. Nicht verfügbar auf 16-Bit Systemen.
Die Einstellungen für das Argument Schaltflächen sind:
Konstante Wert Beschreibung vbOKOnly 0 Nur Schaltfläche OK anzeigen. vbOKCancel 1 Schaltflächen OK und Abbrechen anzeigen. vbAbortRetryIgnore 2 Schaltflächen Abbrechen, Wiederholen und Ignorieren anzeigen. vbYesNoCancel 3 Schaltflächen Ja, Nein und Abbrechen anzeigen. vbYesNo 4 Schaltflächen Ja und Nein anzeigen. vbRetryCancel 5 Schaltflächen Wiederholen und Abbrechen anzeigen. vbCritical 16 Meldung mit Stop-Symbol anzeigen. vbQuestion 32 Meldung mit Fragezeichen-Symbol anzeigen. vbExclamation 48 Meldung mit Ausrufezeichen-Symbol anzeigen. vbInformation 64 Meldung mit Info-Symbol anzeigen. vbDefaultButton1 0 Erste Schaltfläche ist Voreinstellung. vbDefaultButton2 256 Zweite Schaltfläche ist Voreinstellung. vbDefaultButton3 512 Dritte Schaltfläche ist Voreinstellung. vbDefaultButton4 768 Vierte Schaltfläche ist Voreinstellung. vbApplicationModal 0 Anwendungsgebunden. Der Benutzer muß auf das Meldungsfeld reagieren, bevor er die Arbeit mit der aktuellen Anwendung fortsetzen kann. vbSystemModal 4096 Systemgebunden. Alle Anwendungen werden unterbrochen, bis der Benutzer auf das Meldungsfeld reagiert.
Die erste Gruppe von Werten (0–5) beschreibt Anzahl und Typ der im Dialogfeld angezeigten Schaltflächen, die zweite Gruppe (16, 32, 48, 64) beschreibt die Art des Symbols, die dritte Gruppe (0, 256, 512, 768) legt die voreingestellte Schaltfläche fest, und die vierte Gruppe (0, 4096) legt fest, in welcher Form das Meldungsfeld gebunden ist. Verwenden Sie beim Kombinieren von Zahlen zu einen Gesamtwert für das Argument Schaltflächen nur einen Wert aus jeder Gruppe.
Die MsgBox-Funktion besitzt die folgenden Rückgabewerte:
Konstante Wert Schaltfläche vbOK 1 OK vbCancel 2 Abbrechen vbAbort 3 Abruch vbRetry 4 Wiederholen vbIgnore 5 Ignorieren vbYes 6 Ja vbNo 7 Nein
Wenn Sie Hilfedatei und Kontext angeben, kann der Benutzer F1 drücken, um das zum Kontext passende Hilfethema anzuzeigen.Wenn im Dialogfeld die Schaltfläche Abbrechen angezeigt wird, hat das Drücken der ESC-TASTE dieselbe Wirkung wie das Klicken auf Abbrechen. Wenn im Dialogfeld die Schaltfläche Hilfe angezeigt wird, wird eine kontextbezogene Hilfe für das Dialogfeld zur Verfügung gestellt. Ein Wert wird aber nur zurückgegeben, wenn eine der anderen Schaltflächen gewählt wird.