MsgBox
Zeigt eine Meldung in einem Dialogfeld an, wartet darauf, dass der Benutzer auf eine Schaltfläche klickt, und gibt einen Wert zurück, der angibt, welche Schaltfläche der Benutzer angeklickt hat.
Aufbau
MsgBox(Eingabeaufforderung[, Schaltflächen][, Titel][, Hilfedatei, Kontext])
Parameter
Eingabeaufforderung – Zeichenfolgenausdruck, der als Meldung im Dialogfeld angezeigt wird. Die maximale Länge der Eingabeaufforderung beträgt etwa 1024 Zeichen, abhängig von der Breite der verwendeten Zeichen. Wenn die Eingabeaufforderung aus mehr als einer Zeile besteht, können Sie die Zeilen durch ein Wagenrücklaufzeichen (Chr(13)), ein Zeilenvorschubzeichen (Chr(10)) oder eine Kombination aus Wagenrücklauf- und Zeilenvorschubzeichen (Chr(13) & Chr(10)) zwischen den einzelnen Zeilen trennen.
Schaltflächen – Numerischer Ausdruck, der die Summe der Werte darstellt, welche die Anzahl und den Typ der anzuzeigenden Schaltflächen, den zu verwendenden Symbolstil, die Kennung der Standardschaltfläche und die Modalität des Meldungsfelds festlegen. Die Werte finden Sie im Abschnitt „Einstellungen“. Wird dieser Wert weggelassen, beträgt der Standardwert für Schaltflächen 0.
Titel – Zeichenfolgenausdruck, der in der Titelleiste des Dialogfelds angezeigt wird. Wenn Sie den Titel weglassen, wird der Name der Anwendung in der Titelleiste angezeigt.
helpfile – Zeichenfolgenausdruck, der die Hilfedatei angibt, die für die kontextsensitive Hilfe des Dialogfelds verwendet werden soll. Wenn „helpfile“ angegeben wird, muss auch „context“ angegeben werden. Nicht verfügbar auf 16-Bit-Plattformen.
Kontext – Numerischer Ausdruck, der die vom Hilfeautor dem entsprechenden Hilfethema zugewiesene Hilfe-Kontextsnummer angibt. Wenn ein Kontext angegeben wird, muss auch eine Hilfedatei angegeben werden. Nicht verfügbar auf 16-Bit-Plattformen.
Parameterwerte
Die Einstellungen für das Argument „buttons“ lauten:
Konstante Wert Beschreibung
vbOKOnly 0 Nur die Schaltfläche „OK“ anzeigen.
vbOKCancel 1 Zeigt die Schaltflächen „OK“ und „Abbrechen“ an.
vbAbortRetryIgnore 2 Schaltflächen für „Abbrechen“, „Wiederholen“ und „Ignorieren“ anzeigen.
vbYesNoCancel 3 Zeigt die Schaltflächen „Ja“, „Nein“ und „Abbrechen“ an.
vbYesNo 4 Zeige die Schaltflächen „Ja“ und „Nein“ an.
vbRetryCancel 5 Schaltflächen für „Erneut versuchen“ und „Abbrechen“ anzeigen.
vbCritical 16 Symbol für kritische Meldung anzeigen.
vbFrage 32: Symbol für Warnungsabfrage anzeigen.
vbExclamation 48 Symbol für Warnmeldung anzeigen.
vbInformation 64 Symbol für Informationsmeldung anzeigen.
vbDefaultButton1 0 Die erste Schaltfläche ist die Standardschaltfläche.
vbDefaultButton2 256 Die zweite Schaltfläche ist die Standardschaltfläche.
vbDefaultButton3 512 Die dritte Schaltfläche ist die Standardschaltfläche.
vbDefaultButton4 768 Die vierte Schaltfläche ist die Standardschaltfläche.
vbApplicationModal 0 Anwendungsmodal; der Benutzer muss auf das Meldungsfeld reagieren, bevor er die Arbeit in der aktuellen Anwendung fortsetzen kann.
vbSystemModal 4096 Systemmodal; alle Anwendungen werden angehalten, bis der Benutzer auf das Meldungsfeld reagiert.
Die erste Wertegruppe (0–5) beschreibt die Anzahl und Art der im Dialogfeld angezeigten Schaltflächen; die zweite Gruppe (16, 32, 48, 64) beschreibt den Symbolstil; die dritte Gruppe (0, 256, 512, 768) legt fest, welche Schaltfläche die Standardschaltfläche ist; und die vierte Gruppe (0, 4096) bestimmt die Modalität des Meldungsfelds. Wenn Sie Zahlen addieren, um einen Endwert für die Schaltflächen zu ermitteln, verwenden Sie bitte nur eine Zahl aus jeder Gruppe.
Rückgabewert
Die Funktion „MsgBox“ liefert folgende Rückgabewerte:
Schaltfläche „Konstanter Wert“
vbOK 1 OK
vbCancel 2 Abbrechen
vbAbort 3 Abbrechen
vbRetry 4 Wiederholen
vbIgnore 5 Ignorieren
vbJa 6 Ja
Nr. 7 Nein
Beschreibung
Wenn sowohl die Hilfedatei als auch der Kontext angegeben sind, kann der Benutzer die Taste F1 drücken, um den zum Kontext passenden Hilfethemenbereich anzuzeigen.
Wenn im Dialogfeld eine Schaltfläche „Abbrechen“ angezeigt wird, hat das Drücken der ESC-Taste denselben Effekt wie ein Klick auf „Abbrechen“. Wenn das Dialogfeld eine Hilfe-Schaltfläche enthält, wird eine kontextsensitive Hilfe für das Dialogfeld bereitgestellt. Es wird jedoch erst dann ein Wert zurückgegeben, wenn auf eine der anderen Schaltflächen geklickt wird.
Wenn die Funktion „MsgBox“ im Microsoft Internet Explorer verwendet wird, enthält der Titel jedes angezeigten Dialogfelds immer den Zusatz „VBScript:“, um es von den Standard-Systemdialogfeldern zu unterscheiden.
Beispiel
Im folgenden Beispiel wird die Funktion „MsgBox“ verwendet, um ein Meldungsfeld anzuzeigen und einen Wert zurückzugeben, der angibt, welche Schaltfläche angeklickt wurde:
Dim MyVar
MyVar = MsgBox("Hello World!", 65, "MsgBox-Beispiel") ' MyVar enthält entweder 1 oder 2, je nachdem, welche Schaltfläche angeklickt wurde. |