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

 

buttontypeOne of OK, OKCANCEL, YESNO, YESNOCANCEL, RETRYCANCEL, ABORTRETRYIGNORE, CANCELTRYCONTINUE, CONTINUEABORT, SKIPSKIPALLCANCEL, or IGNOREIGNOREALLCANCEL
titleText für die Titelleiste des Meldungsfelds.
promptText, der innerhalb des Meldungsfeldes erscheint.

 

/1 (erste Schaltfläche) /M(modales System)
/2 (zweite Schaltfläche) /N(kein Ton)        
/3 (rd. Schaltfläche) /O(oberstes Fenster)
/4 (dritte Taste) /P(Bildschirmkoordinaten)        
/5 (dritte Taste) /Pc(Mitte)
/6 (dritte Schaltfläche) /Q(Fragesymbol)
/B (Hintergrundfarbe) /R(rechtsbündige Schaltflächen)        
/F (Vordergrundfarbe) /S(oberes Symbol)
/D(vorübergehend einschaltbar) /T(Zeitlimit)                
/H(elp button) /W(arning icon)
/I(nformationssymbol) /X(nicht verschiebbar)
/L(Begrenzte Breite)

 

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:

 

/=Zeigt das MSGBOX-Befehlsdialogfeld an, um Ihnen beim Einstellen der Befehlszeilenoptionen zu helfen. Die Option /= kann an einer beliebigen Stelle in der Zeile stehen; zusätzliche Optionen setzen die entsprechenden Felder im Befehlsdialog.

 

/1Wenn 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.

 

/3Wenn 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.

 

/4Wenn 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.

 

/5Wenn 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.

 

/6Wenn 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.

 

/BrgbHintergrundfarbe, als Hexadezimalzahl, wobei Blau die höchstwertigen 2 Bytes, Grün die mittleren zwei und Rot die niedrigstwertigen sind. Zum Beispiel setzt /BAA8866 Blau auf AA, Grün auf 88 und Rot auf 66.

 

/DnDeaktiviert die Schaltflächen der Nachrichtenbox  beim Startfür n Sekunden.

 

/FrgbTextfarbe, als Hexadezimalzahl, wobei Blau die höchstwertigen 2 Bytes, Grün die mittleren zwei und Rot die niedrigstwertigen sind. Zum Beispiel wird mit /FAA8866 Blau auf AA, Grün auf 88 und Rot auf 66 gesetzt.

 

/HZeigt eine Hilfeschaltfläche an.

 

/IZeigt ein Symbol, bestehend aus einem kleinen "i" in einem Kreis, im Nachrichtenfeld an.

 

/LBegrenzen Sie die maximale Breite des Meldungsfensters auf maximal 1/3 der Bildschirmbreite (es sei denn, der Text der Schaltfläche erfordert mehr).

 

/MDas Fenster des Nachrichtenfeldes wird über allen anderen Fenstern angezeigt.

 

/NDer Standardsound wird nicht abgespielt.

 

/O Das Meldungsfenster wird als oberstes Fenster erstellt.

 

/Px,yDie anfänglichen x,y-Bildschirmkoordinaten. Wenn Sie diese Option nicht verwenden, zentriert MSGBOX sein Fenster im Take Command Registerkartenfenster oder dem TCC Konsolenfenster.

 

/PcZentriert das MSGBOX-Fenster auf dem Desktop.

 

/QZeigt ein Fragezeichen-Symbol im Nachrichtenfeld an.

 

/RDie Schaltflächen werden rechtsbündig ausgerichtet.

 

/SAnzeige eines Stoppschild-Symbols in der Nachrichtenbox.

 

/TnMSGBOX wartet maximal n Sekunden auf eine Antwort (und wird dann geschlossen). Wenn das Zeitlimit abgelaufen ist, wird%_? auf 20 gesetzt. Die verbleibende Zeit bis zum Schließen des Fensters wird in der Standardschaltfläche angezeigt.

 

/WAnzeige eines Ausrufezeichen-Symbols im Meldungsfenster.

 

/XDas Meldungsfeld kann nicht verschoben werden.