Zweck:Öffnet ein Dialogfeld, um eine Eingabe vom Benutzer zu erhalten und sie in einer Umgebungsvariablen zu speichern.

 

Format:QUERYBOX [/= /CUE="text" /D /E /Ln /P /POS=top,left /Tn] ["title"] prompt %%varname

 

titleText für die Titelleiste des Dialogfelds.
promptText, der im Dialogfeld angezeigt wird.
varnameVariablenname, unter dem die Eingabe gespeichert wird.
/CUECue-Text, der im Eingabefeld angezeigt wird

 

/D(igits only)

/P(assword)

/E(dit vorhandener Wert)

/POS (Iteration)

/L (maximale Länge)

/T(Zeitlimit)

 

Siehe auch: INKEY, INPUT, und MSGBOX.

 

Verwendung:

 

QUERYBOX zeigt ein Dialogfeld mit einer Eingabeaufforderung, einem optionalen Titel und einem String-Eingabefeld an. Dann wartet es auf Ihre Eingabe und setzt alle von Ihnen eingegebenen Zeichen in eine Umgebungsvariable. QUERYBOX wird normalerweise in Batch-Dateien und Aliasen verwendet, um Texteingaben zu erhalten.

 

QUERYBOX ist ähnlich wie INPUT, nur dass es als Popup-Dialogfeld erscheint. Wenn Sie es vorziehen, im Befehlszeilenfenster zu arbeiten, lesen Sie die Befehle INKEY und INPUT.

 

Die Option /CUE zeigt den Cue-Text im Eingabefeld in hellgrau an (er verschwindet, sobald Sie ein Zeichen eingeben).

 

Mit den Standard-Befehlszeilen-Editiertasten können Sie den Eingabetext während der Eingabe bearbeiten. Alle Zeichen, die bis zum Wagenrücklauf eingegeben werden, werden in der Variablen gespeichert.

 

Wenn Sie Strg-C oder Strg-Break drücken , während QUERYBOX auf eine Eingabe wartet, wird die Ausführung eines Alias beendet, und die Ausführung einer Batch-Datei wird unterbrochen, während Sie gefragt werden, ob Sie den Batch-Job abbrechen möchten. Eine Batch-Datei kann Ctrl-C und Ctrl-Break selbst mit ON BREAK behandeln .

 

QUERYBOX gibt  nach einer erfolgreichen Operation denWert Null in der internen Variablen %_?zurück , andernfalls einen Wert ungleich Null (ein Timeout gibt 20 zurück, ein Cancel gibt 2 zurück). Achten Sie darauf, den Rückgabewert in einer anderen Variablen zu speichern oder sofort zu testen; denn der Wert von %_? ändert sich mit jedem internen Befehl.

 

Wenn Sie keine Argumente eingeben, zeigt die QUERYBOX ihren Befehlsdialog an.

 

Beispiel:

 

Abfrage einer Zeichenkette, die in der Variablen NAME gespeichert werden soll:

 

querybox "Dateiname" Geben Sie einen Namen ein: %%name

 

Optionen:        

 

/=Zeigt den QUERYBOX-Befehlsdialog 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.

 

/DAkzeptiert nur numerische Werte.

 

/EErmöglicht die Bearbeitung eines vorhandenen Wertes. Wenn es keinen bestehenden Wert für varname gibt, können Sie mit QUERYBOX einen neuen Wert eingeben.

 

/Ln Setzt die maximale Anzahl von Zeichen, die QUERYBOX akzeptiert, auf n.

 

/PWeist QUERYBOX an, Sternchen anstelle der von Ihnen eingegebenen Zeichen auszugeben.

 

/POSLegt die Dialogposition fest. (Wenn Sie keine Position angeben, zentriert QUERYBOX den Dialog im TCC Fenster.

 

/TnWartet maximal n Sekunden lang auf eine Antwort.