Finalidad:Aparece un cuadro de diálogo para obtener una cadena de entrada del usuario y guardarla en una variable de entorno.

 

Formato:CAJA DE CONSULTA [/= /CUE="texto" /D /E /Ln /P /POS=arriba a la izquierda /Tn] ["título"] mensaje %%varname

 

títuloTexto para la barra de título del cuadro de diálogo.
puntualTexto que aparecerá dentro del cuadro de diálogo.
nombrevarNombre de la variable donde se guardará la entrada.
/SEÑALTexto de entrada para mostrar en el cuadro de entrada

 

/Sólo dígitos)

/Contraseña)

/E(dit valor existente)

/Posición)

/L (longitud máxima)

/Se acabó el tiempo)

 

Ver también: INKEY, ENTRADA y MSGBOX.

 

Uso:

 

QUERYBOX muestra un cuadro de diálogo con un mensaje, un título opcional y un campo de entrada de cadena. Luego espera su entrada y coloca los caracteres que escriba en una variable de entorno. QUERYBOX se utiliza normalmente en archivos por lotes y alias para obtener entrada de texto.

 

QUERYBOX es similar a INPUT, excepto que aparece como un cuadro de diálogo emergente. Si prefiere trabajar dentro de la ventana de la línea de comandos, consulte los comandos INKEY e INPUT.

 

La opción /CUE muestra el texto de la señal en gris claro en el cuadro de entrada (desaparece tan pronto como ingresa un carácter).

 

Se pueden usar teclas de edición de línea de comando estándar para editar la cadena de entrada a medida que se ingresa. Todos los caracteres ingresados ​​hasta el retorno de carro, pero sin incluirlo, se almacenan en la variable.

 

Si presiona Ctrl-C or Ctrl-Pausa Mientras QUERYBOX espera entrada, se finalizará la ejecución de un alias y se suspenderá la ejecución de un archivo por lotes mientras se le pregunta si desea cancelar el trabajo por lotes. Un archivo por lotes puede manejar Ctrl-C y Ctrl-Pausa sí mismo con EN EL ALMUERZO O DESCANSO.

 

QUERYBOX devuelve un valor de cero en la variable interna %_? después de una operación exitosa y, en caso contrario, un valor distinto de cero (un tiempo de espera devuelve 20, una cancelación devuelve 2). Asegúrese de guardar el valor de retorno en otra variable o pruébelo inmediatamente; porque el valor de %_? cambia con cada comando interno.

 

Si no ingresa ningún argumento, QUERYBOX mostrará su cuadro de diálogo de comando.

 

Ejemplo:

 

Para solicitar una cadena y almacenarla en la variable NOMBRE:

 

cuadro de consulta "Nombre de archivo" Introduzca un nombre:  %%name

 

Opciones:        

 

/=Muestre el cuadro de diálogo del comando QUERYBOX para ayudarlo a configurar las opciones de la línea de comando. La opción /= puede estar en cualquier lugar de la línea; Las opciones adicionales establecerán los campos apropiados en el cuadro de diálogo de comando.

 

/DSólo acepta valores numéricos.

 

/ELe permite editar un valor existente. Si no existe ningún valor para nombrevar, QUERYBOX le permite ingresar un nuevo valor.

 

/Ln Establece el número máximo de caracteres que QUERYBOX aceptará n.

 

/PLe dice a QUERYBOX que haga eco de los asteriscos, en lugar de los caracteres que escribe.

 

/POSEstablece la posición del diálogo. (Si no especifica una posición, QUERYBOX centrará el diálogo en el TCC ventana.

 

/TennesseEspere un máximo de n segundos para una respuesta.