caixa de diálogo - On-line na nuvem

PROGRAMA:

NOME

dialog - exibe caixas de diálogo de scripts de shell

SINOPSE

diálogo --Claro
diálogo --criar-rc lima
diálogo --print-maxsize
diálogo opções comuns opções de caixa

DESCRIÇÃO

diálogo é um programa que permite apresentar uma variedade de perguntas ou exibir mensagens
usando caixas de diálogo de um script de shell. Esses tipos de caixas de diálogo são implementados
(embora nem todos sejam necessariamente compilados em diálogo):

lista de construção, calendário, lista, dselecionar, caixa de edição, formulário, fselecionar, calibre, caixa de informação,
caixa de entrada, menu de entrada, cardápio, forma mista, medidor misto, caixa de mensagem (mensagem), caixa de senha,
formulário de senha, pausa, prgbox, caixa de programa, caixa de progresso, radiolista, rangebox, caixa traseira,
tailboxbg, caixa de texto, caixa de tempo, treeview e sim não (sim não).

Você pode colocar mais de uma caixa de diálogo em um script:

· Use o "--e-widget"token para forçar diálogo para prosseguir para a próxima caixa de diálogo, a menos que você
pressionei ESC para cancelar ou

· Basta adicionar os tokens para a próxima caixa de diálogo, formando uma cadeia. A caixa de diálogo interrompe o encadeamento
quando o código de retorno de um diálogo é diferente de zero, por exemplo, Cancelar ou Não (veja DIAGNÓSTICOS).

Alguns widgets, por exemplo, lista de verificação, escreverão texto para diálogosaída. Normalmente esse é o
erro padrão, mas existem opções para alterar isso: "--saída-fd""--stderr"E
"--stdout". Nenhum texto será escrito se o botão Cancelar (ou ESC) for pressionado; diálogo saídas
imediatamente nesse caso.

OPÇÕES

Todas as opções começam com "--" (dois hífens ASCII, para benefício de quem usa sistemas
com suporte de localidade perturbado).

Um "--"por si só é usado como escape, ou seja, o próximo token na linha de comando não é
tratado como uma opção.
diálogo --título -- --Não an opção

O "--args"opção diz diálogo para listar os parâmetros da linha de comando para o padrão
erro. Isso é útil ao depurar scripts complexos usando o "--"E"--Arquivo", desde
a linha de comando pode ser reescrita à medida que são expandidas.

O "--Arquivo"opção diz diálogo para ler parâmetros do arquivo nomeado como seu valor.
diálogo --Arquivo arquivo de parâmetros
Espaços em branco que não estejam entre aspas duplas são descartados (use barras invertidas para citar
personagens). O resultado é inserido na linha de comando, substituindo "--Arquivo" e os seus
valor da opção. A interpretação da linha de comando é retomada a partir desse ponto. Se
arquivo de parâmetros começa com "&", diálogo interpreta o seguinte texto como um descritor de arquivo
número em vez de um nome de arquivo.

comum Opções
A maioria das opções comuns são redefinidas antes do processamento de cada widget.

--linhas ascii
Em vez de desenhar linhas gráficas ao redor das caixas, desenhe ASCII "+" e "-" no mesmo
lugar. Veja também "- sem linhas".

--aspecto relação
Isso lhe dá algum controle sobre as dimensões da caixa ao usar o dimensionamento automático
(especificando 0 para altura e largura). Representa largura/altura. O padrão é
9, o que significa 9 caracteres de largura para cada linha de altura.

--backtitle contra-título
Especifica um contra-título string a ser exibida no pano de fundo, na parte superior do
tela.

--começar y x
Especifique a posição do canto superior esquerdo de uma caixa de diálogo na tela.

--cancelar-etiqueta corda
Substitua o rótulo usado para os botões "Cancelar".

--Claro
Limpa a tela do widget, mantendo apenas o fundo screen_color. Use isso quando
você combina widgets com "--e-widget"para apagar o conteúdo de um widget anterior
na tela, para que não seja visto no conteúdo do widget seguinte.
Entenda isso como o complemento de "--keep-janela". Para comparar os efeitos, use
estes:

Todos os três widgets visíveis, efeito escada, ordenados 1,2,3:

diálogo \
--begin 2 2 --sim não "" 0 0 \
--and-widget --begin 4 4 --yesno "" 0 0 \
--and-widget --begin 6 6 --yesno "" 0 0

Apenas o último widget fica visível:

diálogo \
--clear --begin 2 2 --yesno "" 0 0 \
--and-widget --clear --begin 4 4 --yesno "" 0 0 \
--and-widget --begin 6 6 --yesno "" 0 0

Todos os três widgets visíveis, efeito escada, ordenados 3,2,1:

diálogo \
--keep-window --begin 2 2 --yesno "" 0 0 \
--and-widget --keep-window --begin 4 4 --yesno "" 0 0 \
--and-widget --begin 6 6 --yesno "" 0 0

Primeiro e terceiro widget visíveis, efeito escada, ordenados 3,1:

diálogo \
--keep-window --begin 2 2 --yesno "" 0 0 \
--and-widget --clear --begin 4 4 --yesno "" 0 0 \
--and-widget --begin 6 6 --yesno "" 0 0

Observe, se você deseja restaurar as cores originais do console e enviar o cursor para casa
depois que o programa de diálogo for encerrado, use o remover filtragem (1) comando.

--cores
Interprete sequências "\Z" incorporadas no texto da caixa de diálogo pelo seguinte caractere,
que diz diálogo para definir cores ou atributos de vídeo:

· 0 a 7 são os números de cores ANSI usados ​​em maldições: preto, vermelho, verde,
amarelo, azul, magenta, ciano e branco respectivamente.

· Negrito é definido por 'b', redefinido por 'B'.

· A reversão é definida por 'r', redefinida por 'R'.

· O sublinhado é definido por 'u', redefinido por 'U'.

· As configurações são cumulativas, por exemplo, "\Zb\Z1" deixa o texto a seguir em negrito
(talvez brilhante) vermelho.

· Restaure as configurações normais com "\Zn".

--coluna-separador corda
Avisar diálogo para dividir dados para rádio/caixas de seleção e menus nas ocorrências do
determinada string e para alinhar os dados divididos em colunas.

--cr-wrap
Interprete as novas linhas incorporadas no texto da caixa de diálogo como uma nova linha na tela.
Caso contrário, diálogo quebrará as linhas apenas onde for necessário para caber dentro da caixa de texto.

Mesmo que você possa controlar as quebras de linha com isso, diálogo ainda irá quebrar todas as linhas
que são muito longos para a largura da caixa. Sem cr-wrap, o layout do seu
o texto pode ser formatado para ficar bonito no código-fonte do seu script sem
afetando a aparência da caixa de diálogo.

Veja também o "- sem colapso"E"--aparar"opções.

--criar-rc lima
Quando diálogo suporta configuração em tempo de execução, isso pode ser usado para despejar uma amostra
arquivo de configuração para o arquivo especificado por lima.

--Formato de data formato
Se o anfitrião fornecer horário de trabalho, esta opção permite especificar o formato do
data impressa para o --calendário ferramenta. A hora do dia (hora, minuto, segundo) é
a hora local atual.

--defaultno
Faça o valor padrão do sim não caixa um Não. Da mesma forma, torne o botão padrão
de widgets que fornecem "OK" e "Cancelar" um Cancelar. Se "- não cancelar"Ou"--Visita-
Unid"receber essas opções substitui isso, fazendo com que o botão padrão seja sempre
"Sim" (internamente igual a "OK").

--botão padrão corda
Defina o botão padrão (pré-selecionado) em um widget. Ao pré-selecionar um botão, um
script permite que o usuário simplesmente pressione Entrar prosseguir através de um
diálogo com interação mínima.

O valor da opção é o nome do botão: ok, sim, cancelar, não, ajudar or extra.

Normalmente, o primeiro botão de cada widget é o padrão. O primeiro botão mostrado é
determinado pelo widget junto com o "--recanto"E"- não cancelar opções. Se
esta opção não é fornecida, não há botão padrão atribuído.

--item padrão corda
Defina o item padrão em uma lista de verificação, formulário ou caixa de menu. Normalmente o primeiro item
a caixa é o padrão.

--exit-label corda
Substitua o rótulo usado para os botões "SAIR".

--botão extra
Mostrar um botão extra, entre os botões “OK” e “Cancelar”.

--rótulo extra corda
Substitua o rótulo usado para botões "Extra". Nota: para widgets de menu de entrada, isso
o padrão é "Renomear".

--Socorro Imprime a mensagem de ajuda na saída padrão e sai. A mensagem de ajuda também é
impresso se nenhuma opção for fornecida ou se uma opção não reconhecida for fornecida.

- botão de ajuda
Mostrar um botão de ajuda após os botões "OK" e "Cancelar", ou seja, na lista de verificação, lista de rádio
e caixas de menu.

Ao sair, o status de retorno indicará que o botão Ajuda foi pressionado. diálogo
também escreverá uma mensagem em sua saída após o token "HELP":

· Se "--item-ajuda" também for fornecido, o texto de ajuda do item será escrito.

· Caso contrário, será escrita a tag do item (primeiro campo).

Você pode usar o --help-tags opção e/ou definir o ambiente DIALOG_ITEM_HELP
variável para modificar essas mensagens e o status de saída.

--help-label corda
Substitua o rótulo usado para os botões "Ajuda".

--help-status
Se o botão de ajuda estiver selecionado, escreve a lista de verificação, lista de rádio ou informações do formulário
após a informação "HELP" do item-help. Isso pode ser usado para reconstruir o estado
de uma lista de verificação após processar o pedido de ajuda.

--help-tags
Modifique as mensagens escritas na saída para - botão de ajuda fazendo-os sempre apenas
a etiqueta do item. Isso não afeta o código de status de saída.

--hfile nome do arquivo
Exiba o arquivo fornecido usando uma caixa de texto quando o usuário pressionar F1.

--hline corda
Exiba a string fornecida centralizada na parte inferior do widget.

--ignorar
Ignore as opções que diálogo não reconhece. Alguns conhecidos como
"--ícone"são ignorados de qualquer maneira, mas esta é uma escolha melhor para compatibilidade com
outras implementações.

--input-fd fd
Leia a entrada do teclado do descritor de arquivo fornecido. Maioria diálogo scripts lidos de
a entrada padrão, mas o widget do medidor lê um tubo (que é sempre padrão
entrada). Algumas configurações não funcionam corretamente quando diálogo tenta reabrir o
terminal. Use esta opção (com malabarismo apropriado de descritores de arquivo) se o seu
script deve funcionar nesse tipo de ambiente.

--inseguro
Torna o widget de senha mais amigável, mas menos seguro, exibindo asteriscos para cada
personagem.

--iso-semana
Defina o ponto de partida para o número da semana mostrado na caixa "--calendário"opção
de acordo com a ISO-8601, que inicia a numeração na primeira semana que inclui um
Quinta-feira de janeiro.

--item-ajuda
Interpretar os dados das tags para checklist, radiolist e caixas de menu adicionando uma coluna
que é exibido na linha inferior da tela, para o atualmente selecionado
item.

--keep-tite
Quando construído com maldições, diálogo normalmente verifica se está sendo executado em um
xterme, nesse caso, tenta suprimir as strings de inicialização que seriam
faça com que ele mude para a tela alternativa. Alternando entre o normal e o alternativo
telas distrai visualmente em um script que é executado diálogo várias vezes. Usar
esta opção para permitir diálogo para usar essas strings de inicialização.

--keep-janela
Normalmente quando diálogo executa vários tailboxbg widgets conectados por "--e-
Widget", ele limpa o widget antigo da tela pintando sobre ele. Use isto
opção de suprimir essa repintura.

Na saída, diálogo redesenha todos os widgets que foram marcados com "--guarda-
janela", mesmo que não sejam tailboxbg widgets. Isso faz com que eles sejam repintados
Em ordem inversa. Veja a discussão do "--Claro"opção para exemplos.

--última chave
Ao sair, informe a última chave que o usuário digitou. Este é o código-chave da maldição
em vez de um símbolo ou caractere literal. Ele pode ser usado por scripts para
distinguir entre duas chaves que estão vinculadas à mesma ação.

--max-entrada tamanho
Limite as strings de entrada ao tamanho fornecido. Se não for especificado, o limite é 2048.

--sem cancelamento

- não cancelar
Suprima o botão "Cancelar" nos modos lista de verificação, caixa de entrada e caixa de menu. Um roteiro
ainda pode testar se o usuário pressionou a tecla ESC para cancelar e sair.

- sem colapso
Normalmente diálogo converte tabulações em espaços e reduz vários espaços a um único
espaço para texto que é exibido em caixas de mensagem, etc. Use esta opção para
desabilitar esse recurso. Observe que diálogo ainda quebrará o texto, sujeito ao "--cr-
embrulho"E"--aparar"opções.

--sem itens
Alguns widgets (checklist, inputmenu, radiolist, menu) exibem uma lista com dois
colunas (uma "tag" e "item", ou seja, "descrição"). Esta opção diz diálogo para
leia linhas mais curtas, omitindo a parte "item" da lista. Isto é ocasionalmente
útil, por exemplo, se as tags fornecerem informações suficientes.

Veja também --sem tags. Se ambas as opções forem fornecidas, esta será ignorada.

--não mate
Diz diálogo colocar o tailboxbg caixa em segundo plano, imprimindo seu ID de processo para
diálogosaída. SIGHUP está desabilitado para o processo em segundo plano.

--sem rótulo corda
Substitua o rótulo usado para botões "Não".

- sem linhas
Em vez de desenhar linhas ao redor das caixas, desenhe espaços no mesmo lugar. Veja também
"--linhas ascii".

--sem mouse
Não habilite o mouse.

--no-nl-expandir
Não converta substrings "\n" do texto da mensagem/prompt em novas linhas literais.

--recanto

--recanto Suprima o botão "OK" nos modos lista de verificação, caixa de entrada e caixa de menu. Um roteiro pode
ainda teste se o usuário pressionou a tecla “Enter” para aceitar os dados.

- sem sombra
Suprima as sombras que seriam desenhadas à direita e na parte inferior de cada caixa de diálogo.

--sem tags
Alguns widgets (checklist, inputmenu, radiolist, menu) exibem uma lista com dois
colunas (uma "tag" e uma "descrição"). A tag é útil para scripts, mas pode não
ajudar o usuário. O --sem tags opção (do Xdialog) pode ser usada para suprimir o
coluna de tags do display. Ao contrário do --sem itens opção, isso não
afetam os dados que são lidos no script.

O Xdialog não exibe a coluna de tags para buildlist e treeview análogos
widgets; diálogo faz o mesmo.

Normalmente diálogo permite que você passe rapidamente para as entradas na lista exibida,
combinando um único caractere com o primeiro caractere da tag. Quando o --sem tags
opção é dada, diálogo corresponde ao primeiro caractere da descrição. Em
em ambos os casos, o caractere correspondente é destacado.

--ok-rótulo corda
Substitua o rótulo usado para os botões "OK".

--saída-fd fd
Saída direta para o descritor de arquivo fornecido. Maioria diálogo scripts escrevem para o
erro padrão, mas mensagens de erro também podem ser escritas lá, dependendo do seu
script.

--separador corda

--separador de saídacorda
Especifique uma string que separará a saída em diálogosaída de listas de verificação,
em vez de uma nova linha (por --saída separada) ou um espaço. Isto se aplica a outros
widgets como formulários e caixas de edição que normalmente usam uma nova linha.

--print-maxsize
Imprima o tamanho máximo das caixas de diálogo, ou seja, o tamanho da tela, para diálogosaída de.
Isto pode ser usado sozinho, sem outras opções.

- tamanho da impressão
Imprime o tamanho de cada caixa de diálogo para diálogosaída de.

--versão de impressão
REVELAÇÃO DE FOTOS diálogoversão para diálogosaída. Isto pode ser usado sozinho, sem outros
opções. Não causa diálogo para sair sozinho.

--citado
Normalmente diálogo cita as strings retornadas pelas listas de verificação, bem como o item-help
texto. Use esta opção para citar todos os resultados de string.

--Barra de rolagem
Para widgets que contêm um conjunto de dados roláveis, desenhe uma barra de rolagem na margem direita.
Isso não responde ao mouse.

--saída separada
Para certos widgets (buildlist, checklist, treeview), produza o resultado uma linha por
tempo, sem cotação. Isso facilita a análise por outro programa.

--separate-widget corda
Especifique uma string que separará a saída em diálogoa saída de cada widget.
Isto é usado para simplificar a análise do resultado de uma caixa de diálogo com vários widgets. Se
esta opção não é fornecida, a string separadora padrão é um caractere de tabulação.

--sombra
Desenhe uma sombra à direita e na parte inferior de cada caixa de diálogo.

-- aspas simples
Use aspas simples conforme necessário (e sem aspas se desnecessário) para a saída de
lista de verificação, bem como o texto de ajuda do item. Se esta opção não estiver definida, diálogo usos
aspas duplas em torno de cada item. Em ambos os casos, diálogo adiciona barras invertidas para fazer
a saída é útil em scripts de shell.

--size-err
Verifique o tamanho resultante de uma caixa de diálogo antes de tentar utilizá-la, imprimindo o
tamanho resultante se for maior que a tela. (Esta opção é obsoleta, pois
todas as chamadas de nova janela são verificadas).

--dormir seg
Suspensão (atraso) por um determinado número de segundos após o processamento de uma caixa de diálogo.

--stderr
Saída direta para o erro padrão. Este é o padrão, já que as maldições normalmente
grava atualizações de tela na saída padrão.

--stdout
Saída direta para a saída padrão. Esta opção é fornecida para compatibilidade
com o Xdialog, porém não é recomendado usá-lo em scripts portáteis, pois maldições
normalmente grava suas atualizações de tela na saída padrão. Se você usar esta opção,
diálogo tenta reabrir o terminal para que ele possa escrever no display. Dependendo
na plataforma e no seu ambiente, isso pode falhar.

--tab-correto
Converta cada caractere de tabulação em um ou mais espaços (para o caixa de texto ferramenta; de outra forma
para um único espaço). Caso contrário, as guias serão renderizadas de acordo com a biblioteca de maldições
interpretação.

--tab-len n
Especifique o número de espaços que um caractere de tabulação ocupa se o "--tab-correto"
opção é dada. O padrão é 8. Esta opção só é eficaz para o caixa de texto
ferramenta.

--formato de hora formato
Se o anfitrião fornecer horário de trabalho, esta opção permite especificar o formato do
hora impressa para o --timebox ferramenta. Os valores de dia, mês e ano neste caso
são para a hora local atual.

--tempo esgotado seg
Tempo limite (saída com código de erro) se nenhuma resposta do usuário dentro do número determinado de
segundos. Um tempo limite de zero segundos é ignorado.

Esta opção é ignorada pelo "--pausa"widget. Também será substituído se o
fundo "--tailboxbg"A opção é usada para configurar vários widgets simultâneos.

--título título
Especifica um título string a ser exibida na parte superior da caixa de diálogo.

--vestígio nome do arquivo
registra os parâmetros da linha de comando, pressionamentos de tecla e outras informações no determinado
Arquivo. Se diálogo lê um arquivo de configuração, ele também é registrado. Entrada canalizada para o
calibre widget está registrado. Use control/T para registrar uma imagem da caixa de diálogo atual
janela.

--início da semana dia
define o dia de início da semana, usado no "--calendário"opção. O dia
parâmetro pode ser

· um número (0 a 6, de domingo a sábado usando POSIX) ou

· o valor especial "locale" (funciona com sistemas que usam glibc, fornecendo uma
extensão para o local comando, o primeiro_dia da semana valor).

· uma string correspondente a uma das abreviaturas do dia da semana mostrada no
calendário widget, por exemplo, "Mo" para "segunda-feira".

A diálogo programa lida especialmente com alguns parâmetros de linha de comando e os remove de
lista de parâmetros à medida que são processados. Por exemplo, se a primeira opção for --vestígio,
então isso é processado (e removido) antes diálogo inicializa a exibição.

--aparar eliminar espaços em branco iniciais, cortar novas linhas literais e espaços em branco repetidos da mensagem
texto.

Veja também o "--cr-wrap"E"- sem colapso"opções.

--versão
REVELAÇÃO DE FOTOS diálogoversão para a saída padrão e sai. Veja também "--imprimir-
versão".

--visitar-itens
Modifique a passagem de guias da lista de verificação, lista de rádio, caixa de menu e menu de entrada para incluir
a lista de itens como um dos estados. Isto é útil como auxílio visual, ou seja, o
a posição do cursor ajuda alguns usuários.

Quando esta opção é fornecida, o cursor é inicialmente colocado na lista.
Abreviações (a primeira letra da tag) se aplicam aos itens da lista. Se você tabular para
na linha de botões, as abreviaturas se aplicam aos botões.

--sim-rótulo corda
Substitua o rótulo usado para os botões "Sim".

Caixa Opções
Todas as caixas de diálogo possuem pelo menos três parâmetros:

texto a legenda ou o conteúdo da caixa.

altura a altura da caixa de diálogo.

largura a largura da caixa de diálogo.

Outros parâmetros dependem do tipo de caixa.

--buildlist texto altura largura altura da lista [ etiqueta item estado ] ...
A lista de construção A caixa de diálogo exibe duas listas, lado a lado. A lista à esquerda mostra
itens não selecionados. A lista à direita mostra os itens selecionados. Como os itens são
selecionados ou não selecionados, eles se movem entre as listas.

Use um retorno de carro ou o botão "OK" para aceitar o valor atual no
janela selecionada e saia. Os resultados são escritos usando a ordem exibida no
janela selecionada.

O estado inicial ligado/desligado de cada entrada é especificado por estado.

A caixa de diálogo se comporta como um cardápio, Usando o --visitar-itens para controlar se o
cursor tem permissão para visitar as listas diretamente.

· Se --visitar-itens não for fornecido, o tab-traversal usa dois estados (OK/Cancel).

· Se --visitar-itens é fornecido, o tab-traversal usa quatro estados
(Esquerda/Direita/OK/Cancelar).

Se é ou não --visitar-itens é fornecido, é possível mover o destaque entre
as duas listas usando as teclas padrão "^" (coluna esquerda) e "$" (coluna direita).

Na saída, uma lista dos etiqueta strings dessas entradas que estão ativadas serão
impresso em diálogosaída de.

Se o "--saída separada"opção não for fornecida, as strings serão citadas como
necessário para simplificar a separação dos scripts. Por padrão, isso usa
aspas duplas. Veja o "-- aspas simples"opção, que modifica a cotação
comportamento.

--calendário texto altura largura dia mês ano
A calendário caixa exibe mês, dia e ano em janelas ajustáveis ​​separadamente. Se
os valores de dia, mês ou ano estão faltando ou são negativos, a data atual
valores correspondentes são usados. Você pode aumentar ou diminuir qualquer um deles usando
as setas para a esquerda, para cima, para a direita e para baixo. Use o estilo vi h, j, k e l para mover
em torno do conjunto de dias de um mês. Use tab ou backtab para mover-se entre janelas.
Se o ano for dado como zero, a data atual será usada como valor inicial.

Na saída, a data é impressa no formato dia/mês/ano. O formato pode ser
substituído usando o --Formato de data opção.

--lista de controle texto altura largura altura da lista [ etiqueta item estado ] ...
A lista caixa é semelhante a um cardápio caixa; há várias entradas apresentadas em
a forma de um menu. Outra diferença é que você pode indicar qual entrada é
atualmente selecionado, definindo seu estado para on. Em vez de escolher uma entrada
entre as entradas, cada entrada pode ser ativada ou desativada pelo usuário. A inicial
o estado ligado/desligado de cada entrada é especificado por estado.

Na saída, uma lista dos etiqueta strings dessas entradas que estão ativadas serão
impresso em diálogosaída de.

Se o "--saída separada"opção não for fornecida, as strings serão citadas como
necessário para simplificar a separação dos scripts. Por padrão, isso usa
aspas duplas. Veja o "-- aspas simples"opção, que modifica a cotação
comportamento.

--dselect caminho de arquivo altura largura
A caixa de diálogo de seleção de diretório exibe uma janela de entrada de texto na qual você pode digitar um
diretório e, acima disso, uma janela com nomes de diretórios.

Aqui caminho de arquivo pode ser um caminho de arquivo, caso em que a janela do diretório exibirá o
conteúdo do caminho e a janela de entrada de texto conterá o conteúdo pré-selecionado
diretório.

Use as teclas tab ou de seta para mover-se entre as janelas. Na janela do diretório,
use as teclas de seta para cima/para baixo para rolar a seleção atual. Use a barra de espaço para
copie a seleção atual na janela de entrada de texto.

Digitar quaisquer caracteres imprimíveis muda o foco para a janela de entrada de texto, inserindo
esse caractere, bem como rolar a janela do diretório para a correspondência mais próxima.

Use um retorno de carro ou o botão "OK" para aceitar o valor atual no texto-
janela de entrada e saída.

Ao sair, o conteúdo da janela de entrada de texto é gravado em diálogosaída de.

--editbox caminho de arquivo altura largura
A caixa de diálogo da caixa de edição exibe uma cópia do arquivo. Você pode editá-lo usando o
retrocesso, excluir e teclas de cursor para corrigir erros de digitação. Também reconhece
pageup/pagedown. Ao contrário do --caixa de entrada, você deve clicar em "OK" ou "Cancelar"
botões para fechar a caixa de diálogo. Pressionar a tecla “Enter” dentro da caixa irá dividir
a linha correspondente.

Ao sair, o conteúdo da janela de edição é gravado em diálogosaída de.

--Formato texto altura largura altura da forma [ rótulo y x item y x linho ile ] ...
A formulário caixa de diálogo exibe um formulário que consiste em rótulos e campos, que são
posicionado em uma janela rolável por coordenadas fornecidas no script. O campo
comprimento linho e comprimento de entrada ile diga quanto tempo o campo pode ter. O antigo
define o comprimento mostrado para um campo selecionado, enquanto o último define o
comprimento permitido dos dados inseridos no campo.

· Se linho for zero, o campo correspondente não poderá ser alterado. e o conteúdo
do campo determine o comprimento exibido.

· Se linho é negativo, o campo correspondente não pode ser alterado e o campo negado
valor de linho é usado como o comprimento exibido.

· Se ile é zero, está definido como linho.

Use as setas para cima/para baixo (ou control/N, control/P) para mover-se entre os campos. Use a guia para
mover-se entre janelas.

Ao sair, o conteúdo dos campos do formulário é gravado em diálogosaída de, cada campo
separados por uma nova linha. O texto usado para preencher campos não editáveis ​​(linho é zero ou
negativo) não está escrito.

--fselect caminho de arquivo altura largura
A fselecionar (seleção de arquivo) exibe uma janela de entrada de texto na qual você pode
digite um nome de arquivo (ou diretório) e acima dele duas janelas com nomes de diretório e
nomes de arquivos.

Aqui caminho de arquivo pode ser um caminho de arquivo, caso em que as janelas de arquivo e diretório serão
exibirá o conteúdo do caminho e a janela de entrada de texto conterá o
nome de arquivo pré-selecionado.

Use as teclas Tab ou de seta para mover-se entre as janelas. Dentro do diretório ou
janelas de nome de arquivo, use as teclas de seta para cima/para baixo para rolar a seleção atual. Usar
a barra de espaço para copiar a seleção atual na janela de entrada de texto.

Digitar quaisquer caracteres imprimíveis muda o foco para a janela de entrada de texto, inserindo
esse caractere, bem como rolar as janelas de diretório e nome de arquivo para o
correspondência mais próxima.

Digitando as forças do caractere de espaço diálogo para completar o nome atual (até o
ponto onde pode haver uma correspondência contra mais de uma entrada).

Use um retorno de carro ou o botão "OK" para aceitar o valor atual no texto-
janela de entrada e saída.

Ao sair, o conteúdo da janela de entrada de texto é gravado em diálogosaída de.

--medidor texto altura largura [por cento]
A calibre caixa exibe um medidor na parte inferior da caixa. O medidor indica o
percentagem. Novas porcentagens são lidas da entrada padrão, um inteiro por linha.
O medidor é atualizado para refletir cada nova porcentagem. Se a entrada padrão for
a string "XXX", então a primeira linha a seguir é considerada uma porcentagem inteira,
então as linhas subsequentes até outro "XXX" são usadas para um novo prompt. O medidor
sai quando EOF é alcançado na entrada padrão.

A por cento valor denota a porcentagem inicial mostrada no medidor. Se não
especificado, é zero.

Na saída, nenhum texto é escrito diálogosaída. O widget não aceita entrada, então
o status de saída é sempre OK.

--caixa de informação texto altura largura
An info caixa é basicamente um mensagem caixa. No entanto, neste caso, diálogo vai sair
imediatamente após exibir a mensagem ao usuário. A tela não está limpa
quando diálogo sai, para que a mensagem permaneça na tela até o chamador
O shell script limpa isso mais tarde. Isto é útil quando você deseja informar ao usuário que
algumas operações estão em andamento e podem levar algum tempo para serem concluídas.

Na saída, nenhum texto é escrito diálogosaída. Um status de saída OK é retornado.

--caixa de entrada texto altura largura [iniciar]
An entrada caixa é útil quando você deseja fazer perguntas que exigem que o usuário
insira uma string como resposta. Se o init for fornecido, ele será usado para inicializar o
cadeia de entrada. Ao inserir a string, o retrocesso, excluir e as teclas do cursor podem
ser usado para corrigir erros de digitação. Se a string de entrada for maior do que cabe
na caixa de diálogo, o campo de entrada será rolado.

Ao sair, a string de entrada será impressa em diálogosaída de.

--inputmenu texto altura largura altura do menu [ etiqueta item ] ...
An menu de entrada caixa é muito semelhante a uma caixa comum cardápio caixa. Existem apenas alguns
diferenças entre eles:

1. As entradas não são centralizadas automaticamente, mas ajustadas à esquerda.

2. Um botão extra (chamado Rebatizar) está implícito para renomear o item atual quando ele
é pressionado.

3. É possível renomear a entrada atual pressionando o botão Rebatizar botão. Então
diálogo escreverei o seguinte em diálogosaída de.

RENOMEADO

--cardápio texto altura largura altura do menu [ etiqueta item ] ...
Como o próprio nome sugere, um cardápio caixa é uma caixa de diálogo que pode ser usada para apresentar uma lista
de opções na forma de um menu para o usuário escolher. As opções são exibidas em
a ordem dada. Cada entrada do menu consiste em um etiqueta corda e um item fragmento. o
etiqueta dá um nome à entrada para distingui-la das outras entradas no menu.
A item é uma breve descrição da opção que a entrada representa. O usuário
pode mover-se entre as entradas do menu pressionando as teclas do cursor, a primeira letra do
que o etiqueta como uma tecla de atalho ou as teclas numéricas 1 NFT`s 9. tem altura do menu
entradas exibidas no menu ao mesmo tempo, mas o menu será rolado se houver
há mais entradas do que isso.

Na saída do etiqueta da entrada de menu escolhida será impressa em diálogosaída. Se
o "- botão de ajuda" for dada, o texto de ajuda correspondente será impresso se
o usuário seleciona o botão de ajuda.

--forma mista texto altura largura altura da forma [ rótulo y x item y x linho ile Eu digito ] ...
A forma mista caixa de diálogo exibe um formulário que consiste em rótulos e campos, muito parecido com o
--Formato diálogo. Ele difere adicionando um parâmetro de tipo de campo a cada campo
descrição. Cada bit no tipo denota um atributo do campo:

1 oculto, por exemplo, um campo de senha.

2 somente leitura, por exemplo, um rótulo.

--mixedgauge texto altura largura por cento [ tag1 item1 ] ...
A medidor misto caixa exibe um medidor na parte inferior da caixa. O medidor indica
a porcentagem.

Ele também exibe uma lista dos etiqueta e item-valores na parte superior da caixa. Ver
diálogo(3) para os valores das tags.

A texto é mostrado como uma legenda entre a lista e o medidor. O por cento valor
denota a porcentagem inicial mostrada no medidor.

Nenhuma provisão é feita para leitura de dados da entrada padrão como --medidor faz.

Na saída, nenhum texto é escrito diálogosaída. O widget não aceita entrada, então
o status de saída é sempre OK.

--msgbox texto altura largura
A mensagem caixa é muito semelhante a um sim não caixa. A única diferença entre um
mensagem caixa e um sim não caixa é que um mensagem caixa tem apenas um único OK botão.
Você pode usar esta caixa de diálogo para exibir qualquer mensagem que desejar. Depois de ler o
mensagem, o usuário pode pressionar o ENTRAR chave para que diálogo sairá e a chamada
shell script pode continuar sua operação.

Se a mensagem for muito grande para o espaço, diálogo pode permitir que você role,
desde que a implementação das maldições subjacentes seja suficientemente capaz. Nisso
caso, uma porcentagem é mostrada na base do widget.

Na saída, nenhum texto é escrito diálogosaída. Apenas um botão "OK" é fornecido
para entrada, mas um status de saída ESC pode ser retornado.

--pausa texto altura largura segundo
A pausa caixa exibe um medidor na parte inferior da caixa. O medidor indica como
restam muitos segundos até o final da pausa. A pausa termina quando o tempo limite é
alcançado ou o usuário pressiona o botão OK (status OK) ou o usuário pressiona o
Botão CANCELAR ou tecla Esc.

--passwordbox texto altura largura [iniciar]
A senha caixa é semelhante a uma caixa de entrada, exceto que o texto que o usuário insere é
não exibido. Isso é útil ao solicitar senhas ou outras informações confidenciais.
em formação. Esteja ciente de que se algo for passado em "init", será visível em
a tabela de processos do sistema para bisbilhoteiros casuais. Além disso, é muito confuso para o
usuário para fornecer a eles uma senha padrão que eles não podem ver. Por estas razões,
usar "init" é altamente desencorajado. Ver "--inseguro"Se você não se importa com o seu
senha.

Ao sair, a string de entrada será impressa em diálogosaída de.

--passwordform texto altura largura altura da forma [ rótulo y x item y x linho ile ] ...
Isso é idêntico a --Formato exceto que todos os campos de texto são tratados como senha
widgets em vez de caixa de entrada widgets.

--prgbox texto comando altura largura

--prgbox comando altura largura
A prgbox é muito semelhante a um caixa de programa.

Esta caixa de diálogo é usada para exibir a saída de um comando especificado como um
argumento para prgbox.

Após a conclusão do comando, o usuário pode pressionar o botão ENTRAR chave para que diálogo precisarão
exit e o shell script de chamada pode continuar sua operação.

Se forem fornecidos três parâmetros, ele exibe o texto abaixo do título, delineado
do conteúdo do arquivo de rolagem. Se apenas dois parâmetros forem fornecidos, este texto será
omitido.

--programbox texto altura largura

--programbox altura largura
A caixa de programa é muito semelhante a um caixa de progresso. A única diferença entre um
programa caixa e um progresso caixa é que um programa caixa exibe um OK botão (mas
somente após a conclusão do comando).

Esta caixa de diálogo é usada para exibir a saída canalizada de um comando. Depois de
comando for concluído, o usuário pode pressionar o ENTRAR chave para que diálogo vai sair e
o shell script de chamada pode continuar sua operação.

Se forem fornecidos três parâmetros, ele exibe o texto abaixo do título, delineado
do conteúdo do arquivo de rolagem. Se apenas dois parâmetros forem fornecidos, este texto será
omitido.

--progressbox texto altura largura

--progressbox altura largura
A caixa de progresso é semelhante a um caixa traseira, exceto que

a) em vez de exibir o conteúdo de um arquivo,
ele exibe a saída canalizada de um comando e

b) ele sairá quando chegar ao final do arquivo
(não há botão "OK").

Se forem fornecidos três parâmetros, ele exibe o texto abaixo do título, delineado
do conteúdo do arquivo de rolagem. Se apenas dois parâmetros forem fornecidos, este texto será
omitido.

--radiolista texto altura largura altura da lista [ etiqueta item estado ] ...
A radiolista caixa é semelhante a um cardápio caixa. A única diferença é que você pode
indicar qual entrada está atualmente selecionada, definindo seu estado para on.

Ao sair, a tag do item selecionado é gravada em diálogosaída de.

--caixa traseira lima altura largura
Exiba o texto de um arquivo em uma caixa de diálogo, como em um comando "tail -f". Rolagem
esquerda/direita usando 'h' e 'l' no estilo vi ou teclas de seta. Um '0' redefine a rolagem.

Na saída, nenhum texto é escrito diálogosaída. Apenas um botão "OK" é fornecido
para entrada, mas um status de saída ESC pode ser retornado.

--rangebox texto altura largura valor mínimo Valor máximo valor padrão
Permitir que o usuário selecione um intervalo de valores, por exemplo, usando um controle deslizante. O diálogo
mostra o valor atual como uma barra (como a caixa de diálogo do medidor). Mover guias ou teclas de seta
o cursor entre os botões e o valor. Quando o cursor está no valor, você
pode editá-lo por:

movimento do cursor para a esquerda/direita para selecionar um dígito a ser modificado

+/- caracteres para aumentar/diminuir o dígito em um

0 através 9
para definir o dígito para o valor fornecido

Algumas teclas também são reconhecidas em todas as posições do cursor:

casa/fim
definir o valor para seu máximo ou mínimo

página para cima/página para baixo
aumente o valor para que o controle deslizante se mova uma coluna

--tailboxbg lima altura largura
Exibir o texto de um arquivo em uma caixa de diálogo como uma tarefa em segundo plano, como em um "tail -f &"
comando. Role para a esquerda/direita usando 'h' e 'l' no estilo vi ou teclas de seta. Um '0'
redefine a rolagem.

A caixa de diálogo trata a tarefa em segundo plano especialmente se houver outros widgets (--e-
Widget) na tela simultaneamente. Até que esses widgets sejam fechados (por exemplo, um
"OK"), diálogo executará todos os widgets tailboxbg no mesmo processo,
pesquisando por atualizações. Você pode usar uma guia para navegar entre os widgets na
tela e feche-os individualmente, por exemplo, pressionando ENTRAR. Uma vez que o não
widgets tailboxbg estão fechados, diálogo bifurca uma cópia de si mesmo em segundo plano,
e imprime seu ID de processo se o "--não mate"opção é dada.

Na saída, nenhum texto é escrito diálogosaída. Apenas um botão "SAIR" é fornecido
para entrada, mas um status de saída ESC pode ser retornado.

NOTA: Versões mais antigas do diálogo bifurcou imediatamente e tentou atualizar o
tela individualmente. Além de ser ruim para o desempenho, era inviável. Alguns
scripts mais antigos podem não funcionar corretamente com o esquema pesquisado.

--caixa de texto lima altura largura
A texto caixa permite exibir o conteúdo de um arquivo de texto em uma caixa de diálogo. Isso é
como um simples visualizador de arquivos de texto. O usuário pode percorrer o arquivo usando o
cursor, page-up, page-down e INÍCIO / FIM teclas disponíveis na maioria dos teclados. Se o
linhas são muito longas para serem exibidas na caixa, o ESQUERDA DIREITA chaves podem ser usadas para
role a região do texto horizontalmente. Você também pode usar teclas estilo vi h, j, k e l
no lugar das teclas do cursor e B ou N no lugar das teclas page up e page down.
Role para cima/para baixo usando 'k' e 'j' no estilo vi ou teclas de seta. Role para a esquerda/direita usando
estilo vi 'h' e 'l', ou teclas de seta. Um '0' redefine a rolagem para a esquerda/direita. Para
mais conveniência, funções de pesquisa para frente e para trás no estilo vi também são
forneceu.

Na saída, nenhum texto é escrito diálogosaída. Apenas um botão "SAIR" é fornecido
para entrada, mas um status de saída ESC pode ser retornado.

--timebox texto altura [largura hora minuto segundo]
É exibida uma caixa de diálogo que permite selecionar hora, minuto e segundo. Se o
valores de hora, minuto ou segundo estão ausentes ou são negativos, a data atual
valores correspondentes são usados. Você pode aumentar ou diminuir qualquer um deles usando
as setas para a esquerda, para cima, para a direita e para baixo. Use tab ou backtab para mover entre
janelas.

Ao sair, o resultado é impresso no formato hora:minuto:segundo. O formato pode ser
substituído usando o --formato de hora opção.

--treeview texto altura largura altura da lista [ etiqueta item estado profundidade ] ...
Exibir dados organizados como uma árvore. Cada grupo de dados contém uma tag, o texto a ser
exibição do item, seu status ("ligado" ou "desligado") e a profundidade do item na
árvore.

Apenas um item pode ser selecionado (como o radiolista). A etiqueta não é exibida.

Ao sair, a tag do item selecionado é gravada em diálogosaída de.

--sim não texto altura largura
A sim não caixa de diálogo de tamanho altura filas por largura colunas serão exibidas. o
string especificada por texto é exibido dentro da caixa de diálogo. Se esta string for também
longo para caber em uma linha, ele será automaticamente dividido em várias linhas em
locais apropriados. o texto string também pode conter a substring "\n"ou
caracteres de nova linha `\n'para controlar explicitamente a quebra de linha. Esta caixa de diálogo é
útil para fazer perguntas que exigem que o usuário responda sim ou não. O
caixa de diálogo tem um Sim botão e um Não botão, no qual o usuário pode alternar entre
pressionando o botão ABA chave.

Na saída, nenhum texto é escrito diálogosaída. Além do "Sim" e do "Não"
códigos de saída (ver DIAGNÓSTICO) um status de saída ESC pode ser retornado.

Os códigos utilizados para “Sim” e “Não” correspondem aos utilizados para “OK” e “Cancelar”,
internamente nenhuma distinção é feita.

Obsoleto Opções
--bip Isso foi usado para informar ao cdialog original que ele deveria emitir um bipe quando o
processos separados do widget tailboxbg redesenhariam a tela.

--beep-depois
Emite um sinal sonoro depois que um usuário conclui um widget pressionando um dos botões.

TEMPO DE EXECUÇÃO CONFIGURAÇÃO

1. Crie um arquivo de configuração de amostra digitando:

diálogo --create-rc lima

2. No início, diálogo determina as configurações a serem usadas da seguinte forma:

a) se variável de ambiente DIALOGRC é definido, seu valor determina o nome do
arquivo de configuração.

b) se o arquivo em (a) não for encontrado, use o arquivo $HOME/.dialogrc como a configuração
arquivo.

c) se o arquivo em (b) não for encontrado, tente usar o arquivo GLOBALRC determinado em
tempo de compilação, ou seja, /etc/dialogrc.

d) se o arquivo em (c) não for encontrado, use compilado em padrões.

3. Edite o arquivo de configuração de amostra e copie-o para algum lugar que diálogo pode encontrar, como
indicado na etapa 2 acima.

KEY LIGAÇÕES

Você pode substituir ou adicionar combinações de teclas em diálogo adicionando ao arquivo de configuração.
diálogo's chave de ligação O comando mapeia chaves únicas para sua codificação interna.

chave de ligação Widget maldições_chave dialog_key

A Widget o nome pode ser "*" (todos os widgets) ou widgets específicos, como caixa de texto. Específico
as ligações do widget substituem as ligações "*". As vinculações definidas pelo usuário substituem as vinculações integradas
ligações.

A maldições_chave pode ser qualquer um dos nomes derivados de maldições.h, por exemplo, "AJUDA" de
"KEY_HELP". diálogo também reconhece caracteres de controle ANSI, como "^A", "^?", bem como
Controles C1 como "~A" e "~?". Finalmente, permite que qualquer caractere único seja escapado
com uma barra invertida.

diálogoOs nomes dos códigos-chave internos correspondem ao DLG_KEYS_ENUM digitar dlg_keys.h, por exemplo,
"AJUDA" de "DLGK_HELP".

widget Names
Alguns widgets (como o formbox) possuem uma área onde os campos podem ser editados. Esses são
gerenciado em uma subjanela do widget e pode ter atalhos de teclado separados do principal
widget porque as subjanelas são registradas com um nome diferente.

widget Janela nome Subjanela Nome
──────────────────────────────────────── ───
calendário
lista de verificação
caixa de edição caixa de edição caixa de edição2

formulário formbox formfield
fselect fselect fselect2
caixa de entrada caixa de entrada caixa de entrada2
menu menucaixa menu
caixa de mensagens caixa de mensagens
pausa pausa
caixa de progresso caixa de progresso
radiolista radiolista
caixa traseira caixa traseira
caixa de texto caixa de texto caixa de pesquisa
caixa de tempo caixa de tempo
sim não sim não
──────────────────────────────────────── ───

Alguns widgets são na verdade outros widgets, usando configurações internas para modificar o comportamento.
Eles usam o mesmo nome de widget do widget real:

widget Real widget
─────────────────────────────────
dselect fselect
caixa de informações caixa de mensagens
menu de entrada
formulário misto
caixa de entrada da caixa de senha
formulário de senha
prgbox caixa de progresso
caixa de progresso da caixa de programa
caixa traseira
─────────────────────────────────

Autenticador Ligações
Esta página de manual não lista as combinações de teclas para cada widget, porque isso detalhado
informações podem ser obtidas executando diálogo. Se você definiu o --vestígio opção, diálogo
grava as informações de atalho de teclado para cada widget à medida que ele é registrado.

Exemplo
Normalmente diálogo usa teclas diferentes para navegar entre os botões e editar parte do
uma caixa de diálogo versus navegar na seção de edição. Ou seja, travessia de tabulação (e tabulação posterior)
botões (ou entre os botões e a parte de edição), enquanto as teclas de seta percorrem os campos dentro
a parte de edição. As guias também são reconhecidas como um caso especial para percorrer entre
widgets, por exemplo, ao usar vários widgets tailboxbg.

Alguns usuários podem desejar usar a mesma chave para percorrer a parte de edição e para
percorrendo entre os botões. O widget de formulário foi escrito para suportar esse tipo de
redefinição das chaves, adicionando um grupo especial em dlgk_keys.h para "forma"
(esquerda/direita/próximo/anterior). Aqui está um exemplo de vinculação que demonstra como fazer isso:

campo de formulário bindkey TAB form_NEXT
bindkey formbox TAB form_NEXT
campo de formulário bindkey BTAB form_prev
bindkey formbox BTAB form_prev

Esse tipo de redefinição não seria útil em outros widgets, por exemplo, calendário, devido ao
número potencialmente grande de campos a percorrer.

MEIO AMBIENTE

DIÁLOGOS Defina esta variável para aplicar qualquer uma das opções comuns a cada widget.
A maioria das opções comuns são redefinidas antes do processamento de cada widget. Se você
definir as opções nesta variável de ambiente, elas serão aplicadas a diálogo's
estado após a reinicialização. Como no "--Arquivo"opção, aspas duplas e
barras invertidas são interpretadas.

O "--Arquivo"não é considerada uma opção comum (portanto, você não pode incorporar
dentro desta variável de ambiente).

DIALOGRC Defina esta variável se quiser especificar o nome da configuração
arquivo a ser usado.

DIALOG_CANCEL

DIALOG_ERROR

DIALOG_ESC

DIALOG_EXTRA

DIALOG_HELP

DIALOG_ITEM_HELP

DIALOG_OK Defina qualquer uma dessas variáveis ​​para alterar o código de saída em Cancelar (1), erro
(-1), ESC (255), Extra (3), Ajuda (2), Ajuda com --item-ajuda (2) ou OK (0).
Normalmente, os scripts de shell não conseguem distinguir entre -1 e 255.

DIALOG_TTY Defina esta variável como "1" para fornecer compatibilidade com versões mais antigas do
diálogo que assumiu que se o script redirecionar a saída padrão, isso
o "--stdout"opção foi dada.

Use o diálogo on-line usando os serviços onworks.net