Finalidad:Mostrar un cuadro de diálogo de tareas de Windows

 

Formato:DIÁLOGO DE TAREAS [/A[F][X]"Detalles"/AC"texto"/AE"texto" /B"texto" /C /DB:n /DR:n /E /F[EISW]"texto" /H /I /L /N /P=x, y /R"texto" /S /T:n /V"texto" /W /X] tipo de botón "título""instrucción"[texto]

 

tipo de botónUno o más de OK, SI NO, VOLVER A INTENTAR, CANCELAR, y/o CERCA
títuloTexto para el título del diálogo de tarea
instrucciónTexto de la instrucción principal.
textoTexto adicional opcional que aparece debajo de la instrucción principal, en una fuente más pequeña

 

/A (detalles)/Enlaces)
/Botón de texto)/N (enlaces)
/Caja)/Posición)
/DB (botón predeterminado)/Botones de radio)
/DR (botón de opción predeterminado)/S(icono superior)
/E (escudo)/Se acabó el tiempo)
/Pie de página)/Verificación)
/H(ypervínculos)/W(icono de advertencia)
/I(icono de información)/X (cerrable)

 

Ver también: INKEY, ENTRADA, MSGBOX CAJA DE CONSULTAS.

 

Uso:

 

El botón que elige el usuario se indica mediante la variable interna %_?. Asegúrese de guardar el valor de retorno en otra variable o pruébelo inmediatamente; porque el valor de %_? cambia con cada comando interno. La siguiente lista muestra el valor devuelto para cada botón:

 

respuesta

%_?

Si o bien

10

No

11

Cancelar o Cerrar

12

Reintente

13

 

Si hay un error en el propio comando TASKDIALOG, %_? se establecerá en 2.

 

Dado que TASKDIALOG no escribe en la salida estándar, deshabilita la redirección y le permite ingresar los caracteres de redirección () en el texto del mensaje. Si desea utilizar caracteres de canalización o separadores de comandos, deberá utilizar caracteres de escape o comillas.

 

TASKDIALOG crea un cuadro de diálogo emergente. Si prefiere recuperar la entrada desde la línea de comando, consulte la INKEY ENTRADA comandos.

 

Puede copiar el texto de una ventana TASKDIALOG al portapapeles ingresando Ctrl-C cuando la ventana TASKDIALOG tiene el foco del teclado.

 

TASKDIALOG puede establecer tres variables internas:

 

_taskdialog_button: el botón presionado para salir de TASKDIALOG

_taskdialog_radio: el botón de opción seleccionado (si lo hay) en TASKDIALOG

_taskdialog_verify: devuelve 1 si se marcó el botón de verificación

 

Ejemplo:

 

Muestre un cuadro de mensaje Sí/No y tome medidas según el resultado:

 

taskdialog sí no "Copiar" "¿Copiar todos los archivos a A:?"

si %_? == 10 copias * a:

 

Opciones:

 

/A"detalles"TASKDIALOG mostrará un botón en el que puede hacer clic para expandir el cuadro de diálogo y ver el texto especificado en "Detalles".

 

/C.A"texto"El texto del botón para contraer la información expandible.

 

/AE"texto"El texto del botón para ampliar la información ampliable.

 

/AF"detalles"Como /A, pero TASKDIALOG mostrará los detalles en la parte inferior del área de pie de página del cuadro de diálogo en lugar de inmediatamente después del contenido.

 

/HACHA"detalles"Como /A, pero TASKDIALOG mostrará los detalles ampliados de forma predeterminada.

 

/B"texto"Texto a utilizar para botones personalizados. Si especifica uno o más argumentos /B, TASKDIALOG no mostrará ninguno de los botones predeterminados. TASKDIALOG devolverá el ID del botón presionado en la variable de comando %_taskdialog_button. TASKDIALOG numerará los ID de los botones personalizados comenzando en 1000. El número máximo de botones personalizados es 10.

 

/CMarque la casilla de verificación al iniciar TASKDIALOG. (La casilla de verificación está desmarcada de forma predeterminada).

 

/DB:xxBotón predeterminado. Puede ser un número (1000-n para botones personalizados o un tipo de botón definido:

 

OK

Si

No

Cancelar

Reintente

Cerrar

 

/DR:nEl botón de opción predeterminado (2000 - n, solo válido cuando se usa con /R).

 

/EMuestra el icono del escudo de seguridad de Windows.

 

/F"texto"DMuestra el texto del pie de página con un icono opcional:

 

Eescudo de seguridad
Iinformación
Serror
Wadvertencia

 

/HEHabilite hipervínculos incrustados en el texto de información adicional (/A), el texto del pie de página (/F) y el texto de instrucciones principal. Los hipervínculos se crean con una pestaña HTML . Por ejemplo:

 

/A"Este es un hipervínculo: Detalles completos sobre Take Command 28"

 

/IMuestra un icono que consiste en una "i" minúscula en un círculo en el cuadro de mensaje.

 

/LConvierta los botones definidos por /B en enlaces de comando. Un enlace de comando es un botón más grande que tiene un ícono y, opcionalmente, una segunda línea de texto más pequeña. (Para mostrar una segunda línea, agregue ^n al argumento /B, seguido del texto de la segunda línea).

 

/NLos botones personalizados (consulte /B y /R) deben mostrarse como enlaces de comando en lugar de botones de opción o pulsadores.

 

/PMuestra el cuadro de diálogo de la tarea en las coordenadas de pantalla especificadas. Si no se especifica /P, TCC-RT centrará el diálogo.

 

/R"texto"Mostrar botones de opción. El botón seleccionado se devolverá en la variable de comando %_taskdialog_radio. TASKDIALOG numerará los ID de los botones de opción personalizados comenzando en 2000. El número máximo de botones de opción es 10.

 

/SMuestra un icono de señal de alto en el cuadro de mensaje.

 

/T:nTiempo de espera después de n segundos. Si TASKDIALOG se agota, devolverá el valor del botón Cancelar/Cerrar (12).

 

/V"texto"Muestra una casilla de verificación. Si la casilla está marcada, la variable de comando %_taskdialog_verify se establecerá cuando salga TASKDIALOG.

 

/WMuestra un icono de signo de exclamación en el cuadro de mensaje.

 

/XTEl cuadro de diálogo de tareas se puede cerrar usando Alt-F4, Escape y el botón de cerrar de la barra de título incluso si no se especifica ningún botón de cancelar.