Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Escolha

Solicita ao usuário selecionar um item de uma lista de opções de caractere único em um programa em lotes e retorna o índice da opção selecionada. Se usado sem parâmetros, opção exibe as opções padrão y e N.

Para obter exemplos de como usar esse comando, consulte exemplos.

Sintaxe



Choice [/c [<Choice1> <Choice2> <…>]] [/n] [/cs] [/t <Timeout>/d <Choice>] [/m < "Text" >]

Parâmetros

Parâmetro Descrição

/c <Choice1> <Choice2> <…>

Especifica a lista de opções a serem criados. As opções válidas incluem a-z, A-Z, 0-9 e caracteres ASCII estendidos (128-254). A lista padrão é "YN", que é exibido como [Y,N]? .

/n

Oculta a lista de opções, embora as opções ainda estão ativadas e o texto da mensagem (se especificado pelo /m) ainda é exibido.

/CS

Especifica as opções são diferencia maiúsculas de minúsculas. Por padrão, as opções não diferenciam maiúsculas de minúsculas.

/t <Timeout>

Especifica o número de segundos de pausa antes de usar a opção padrão especificada pelo /d. Valores aceitáveis são de 0 a 9999. Se /t é definido como 0, choice não pausa antes de retornar a opção padrão.

/d <Choice>

Especifica a opção padrão para usar após esperar o número de segundos especificado por /t. Deve ser a opção padrão na lista de opções especificadas por /c.

/m < "text" >

Especifica uma mensagem para exibir antes de lista de opções. Se /m não for especificado, somente o prompt de escolha é exibido.

/?

Exibe a Ajuda no prompt de comando.

Comentários

  • A variável de ambiente ERRORLEVEL é definida para o índice da chave que o usuário seleciona na lista de opções. A primeira opção na lista retorna um valor de 1, o segundo um valor 2 e assim por diante. Se o usuário pressiona uma tecla que não é uma opção válida, Escolha emitirá um aviso sonoro. Se a opção detectar uma condição de erro, ele retorna um valor ERRORLEVEL de 255. Se o usuário pressionar CTRL + BREAK ou CTRL + C, Escolha retorna um valor ERRORLEVEL 0.

Cc732504.note(pt-br,WS.10).gif Observação
Quando você usar valores ERRORLEVEL de um programa em lote, lista-los em ordem decrescente.

Exemplos

Para apresentar as opções C, N e Y, digite a seguinte linha em um arquivo em lotes:



choice /c snp

O seguinte prompt aparece quando o arquivo em lotes é executado o comando choice :



[Y, N, C]?

Para ocultar as opções C, N e Y, mas exibir o texto "Sim, não ou continuar", digite a seguinte linha em um arquivo em lotes:



choice /c snp /n /m "Sim, não ou continuar?"

O seguinte prompt aparece quando o arquivo em lotes é executado o comando choice :



Sim, não ou prosseguir?

Cc732504.note(pt-br,WS.10).gif Observação
Se você usa o parâmetro /n , mas não use /m, o usuário não é solicitado quando a opção está aguardando entrada.

Para mostrar o texto e as opções usadas nos exemplos anteriores, digite a seguinte linha em um arquivo em lotes:



choice /c snp /m "Sim, não ou continuar"

O seguinte prompt aparece quando o arquivo em lotes é executado o comando choice :



Sim, não ou prosseguir [S, N, C]?

Para definir um limite de tempo de cinco segundos e especificar n como valor padrão, digite a seguinte linha em um arquivo em lotes:



choice /c snp /t 5 /d n

O seguinte prompt aparece quando o arquivo em lotes é executado o comando choice :



[Y, N, C]?

Cc732504.note(pt-br,WS.10).gif Observação
Neste exemplo, se o usuário não pressionar uma tecla dentro de cinco segundos, a opção seleciona n por padrão e retorna um valor de erro de 2. Caso contrário, a opção retorna o valor correspondente à opção do usuário.

Referências adicionais

Contribuições da comunidade

ADICIONAR
Mostrar: