| Zweck: | Anzeige eines Windows-Meldungsfeldes |
| Formatieren: | MSGBOX [/= /1["text"] /2["text"] /3["text"] /4["text"] /5["text"] /6["text"] /Brgb /Dn /H /I /L /M /N /O /Px,y /Pc /Q /R /S /Tn /W /X] buttontype ["title"] prompt |
| buttontype | One of OK, OKCANCEL, YESNO, YESNOCANCEL, RETRYCANCEL, ABORTRETRYIGNORE, CANCELTRYCONTINUE, CONTINUEABORT, SKIPSKIPALLCANCEL, or IGNOREIGNOREALLCANCEL |
| title | Text für die Titelleiste des Meldungsfelds. |
| prompt | Text, der innerhalb des Meldungsfeldes erscheint. |
Siehe auch: INKEY, INPUT, QUERYBOX, und TASKDIALOG.
Verwendung:
MSGBOX kann eine von acht Arten von Nachrichtenboxen anzeigen und auf die Antwort des Benutzers warten. Sie können Titel und Eingabeaufforderungverwenden , um jeden gewünschten Text anzuzeigen. TCC wird die Messagebox automatisch in der Größe und in der Mitte des Tab-Fensters angezeigt (wenn TCC in einem Take Command), oder zentriert auf dem Bildschirm (wenn TCC in einem Konsolenfenster ausgeführt wird). Das Meldungsfeld hat je nach Typ bis zu drei Antwortschaltflächen (plus eine optionale Hilfe-Schaltfläche), wie unten gezeigt.
buttontype |
button 1 |
button 2 |
button 3 |
OK |
OK |
||
OKCANCEL |
OK |
Cancel |
|
YESNO |
Yes |
No |
|
YESNOCANCEL |
Yes |
No |
Cancel |
RETRYCANCEL |
Retry |
Cancel |
|
ABORTRETRYIGNORE |
Abort |
Retry |
Ignore |
CANCELTRYCONTINUE |
Cancel |
Try Again |
Continue |
CONTINUEABORT |
Continue |
Abort |
|
SKIPSKIPALLCANCEL |
Skip |
Skip All |
Cancel |
IGNOREIGNOREALLCANCEL |
Ignore |
Ignore All |
Cancel |
Es gibt zwei Schaltflächenmodifikatoren (nur gültig, wenn sie unmittelbar nach einem YESNO oder YESNOCANCEL verwendet werden):
YESTOALL - fügt eine Schaltfläche "Ja zu allen" hinzu (ergibt 30)
NOTOALL - fügt eine Schaltfläche "Nein zu Allem" hinzu (gibt 31 zurück)
Wenn die Standard-Meldungsfeldtypen nicht Ihren Anforderungen entsprechen, können Sie ein benutzerdefiniertes Meldungsfeld mit bis zu vier Schaltflächen (plus einer optionalen Hilfe-Schaltfläche) erstellen und den Text angeben, der auf jeder Schaltfläche erscheint.
DieSchaltfläche, die der Benutzer auswählt, wird durch die interne Variable %_?angezeigt . Achten Sie darauf, den Rückgabewert in einer anderen Variablen zu speichern oder ihn sofort zu testen, da sich der Wert von %_? mit jedem internen Befehl ändert. Die folgende Liste zeigt den Wert, der für jede Auswahl zurückgegeben wird:
Antwort |
|
Yes or OK |
10 |
No |
11 |
Cancel |
12 |
Retry |
13 |
Try Again |
14 |
Continue |
15 |
Ignore |
16 |
Abort |
17 |
Help |
18 |
timeout |
20 |
Benutzerdefinierte Taste 1 |
21 |
Benutzerdefinierte Taste 2 |
22 |
Benutzerdefinierte Taste 3 |
23 |
Benutzerdefinierte Taste 4 |
24 |
Benutzerdefinierte Taste 5 |
25 |
Benutzerdefinierte Taste 6 |
26 |
Wenn Sie benutzerdefinierte Schaltflächen definieren, wird das Argument Schaltflächentyp ignoriert.
Es gibt drei optionale Checkbox-Typen. (Sie können immer nur einen auswählen.)
DONOTASKAGAIN - fügt das Kontrollkästchen "Nicht mehr nachfragen" hinzu.
DONOTTELLAGAIN - fügt das Kontrollkästchen "Nicht noch einmal sagen" hinzu.
DONOTSHOWAGAIN - Kontrollkästchen "Nicht mehr anzeigen" hinzufügen
Wenn das Kontrollkästchen aktiviert ist, setzt MSGBOX die interne Variable %_msgbox_checkbox auf 1.
Liegt einFehler im MSGBOX-Befehl selbst vor, wird %_? wie in seiner Dokumentation beschrieben gesetzt (siehe _?).
Um zum Beispiel eine Ja- oder Nein-Meldung anzuzeigen und je nach Ergebnis Maßnahmen zu ergreifen, könnten Sie Befehle wie den folgenden verwenden:
msgbox yesno "Copy" Copy all files to A:?
if %_? == 10 copy * a:
Da MSGBOX nicht auf die Standardausgabe schreibt, deaktiviert es die Umleitung und das Piping, damit Sie die Umleitungszeichen (<, > und |) in Ihren Prompt-Text eingeben können.
Sie können den Text in einem MSGBOX-Fenster in die Zwischenablage kopieren, indem Sie Strg-C eingeben, wenn das MSGBOX-Fenster den Tastaturfokus hat.
MSGBOX erstellt ein Popup-Dialogfeld. Wenn Sie es vorziehen, Eingaben über die Befehlszeile abzurufen, lesen Sie die Befehle INKEY und INPUT.
Optionen:
| /1 | Wenn nach der Option eine Textzeichenfolge steht, legen Sie den benutzerdefinierten Text für die erste Schaltfläche fest. Andernfalls wird die erste Schaltfläche als Standard festgelegt. |
| /2 | Wennhinter der Option eine Textzeichenfolge steht, legen Sie den benutzerdefinierten Text für die zweite Schaltfläche fest. Andernfalls wird die zweite Schaltfläche als Standard festgelegt. |
| /3 | Wenn hinter der Option eine Textzeichenfolge steht, legen Sie den benutzerdefinierten Text für die dritte Schaltfläche fest. Andernfalls legen Sie die dritte Schaltfläche als Standard fest. |
| /4 | Wenn hinter der Option eine Textzeichenfolge steht, legen Sie den benutzerdefinierten Text für die vierte Schaltfläche fest. Andernfalls wird die vierte Schaltfläche als Standard festgelegt. |
| /5 | Wenn hinter der Option eine Textzeichenfolge steht, legen Sie den benutzerdefinierten Text für die fünfte Schaltfläche fest. Andernfalls legen Sie die fünfte Schaltfläche als Standard fest. |
| /6 | Wenn hinter der Option eine Textzeichenfolge steht, legen Sie den benutzerdefinierten Text für die sechste Schaltfläche fest. Andernfalls wird die sechste Schaltfläche als Standard festgelegt. |
| /L | Begrenzen Sie die maximale Breite des Meldungsfensters auf maximal 1/3 der Bildschirmbreite (es sei denn, der Text der Schaltfläche erfordert mehr). |
| /Px,y | Die anfänglichen x,y-Bildschirmkoordinaten. Wenn Sie diese Option nicht verwenden, zentriert MSGBOX sein Fenster im Take Command Registerkartenfenster oder dem TCC Konsolenfenster. |