1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
<TITLE>Shellmod: Protocolo</TITLE>
<LINK HREF="intro-4.html" REL=next>
<LINK HREF="intro-2.html" REL=previous>
<LINK HREF="intro.html#toc3" REL=contents>
</HEAD>
<BODY>
<A HREF="intro-4.html">Next</A>
<A HREF="intro-2.html">Previous</A>
<A HREF="intro.html#toc3">Contents</A>
<HR>
<H2><A NAME="s3">3. Protocolo</A></H2>
<P>Nós agora apresentamos os vários comandos editados pelo script. Estes
commandos são divididos por tarefa.
<P>
<H2><A NAME="ss3.1">3.1 Estrutura de comandos e colocação de aspas</A>
</H2>
<P>Todos os comandos são enviados ao shellmod através do comando echo. Eles
sempre se parecem com:
<P>
<BLOCKQUOTE><CODE>
<PRE>
echo command arg1 arg2 arg3
</PRE>
</CODE></BLOCKQUOTE>
<P>Os argumentos podem ser palavras simples, ou várias palavras separadas por espaços.
Para agrupar múltiplas palavras como um argumento simples, deve-se usar aspas.
Apesar de isto ser uma prática comum em linhas de commando, existe um detalhe: as aspas
irão afetar apenas o argumento conforme visto pelo comando <CODE>echo</CODE>.
Uma vez processada, a linha inteira será recebida como um fluxo simples de palavras
separadas por espaços e as aspas desaparecerão. As aspas devem ser parte da linha
recebida pelo shellmod. Veja um exemplo:
<P>
<BLOCKQUOTE><CODE>
<PRE>
echo newf_str name \"Digite seu nome\" \"Tux, o pingüim\"
</PRE>
</CODE></BLOCKQUOTE>
<P>A biblioteca shellmod-lib.sh define a função <CODE>qecho</CODE> que ajudará você
a ter um comportamento de aspas padrão. O seguinte é um exemplo reescrito
com <CODE>qecho</CODE>.
<P>
<BLOCKQUOTE><CODE>
<PRE>
qecho newf_str name "Digite seu nome" 'Tux, o pingüim'
</PRE>
</CODE></BLOCKQUOTE>
<P>Como você pode ver, com <CODE>qecho</CODE> você pode misturar as diferentes sintaxes
de aspas do shell. A função <CODE>qecho</CODE> assegura que as aspas agregam todos
os argumentos.
<P>
<P>
<H2><A NAME="ss3.2">3.2 Enviando parâmetros em várias linhas</A>
</H2>
<P>Scripts shell não são tão bons em manipular e entregar texto em várias linhas.
O comando "defval" foi criado para consertar isso.
Eis aqui uma forma típica de utlização:
<P>
<BLOCKQUOTE><CODE>
<PRE>
echo var1 "Esta é a primeira linha"
echo var1 "Esta é a segunda linha"
echo error =var1
</PRE>
</CODE></BLOCKQUOTE>
<P>Isto cria uma mensagem popup de erro com duas linhas. "defval" é usado
repetidamente para definir o texto em várias linhas e é referenciado como um
argumento utilizando o sinal = . O argumento não pode estar entre aspas. Deste modo,
você não pode utilizar a função qecho usando um parâmetro defvar parameter, porque
qecho necessita de aspas fechando todos os parâmetros.
<P>
<H2><A NAME="ss3.3">3.3 Construindo um diálogo.</A>
</H2>
<P>
<P>
<H3>echo DIALOG</H3>
<P>Um diálogo sempre inicia com este comando. Ele não requere nenhum argumento a mais.
Depois você acrescenta definições de campos, adiciona botões opcionais
e então você chama a função edit. Eis aqui um exemplo:
<P>
<BLOCKQUOTE><CODE>
<PRE>
echo DIALOG
echo newf_str var \"título do campo\" value
edho edit \"Título do diálogo\" \"Introdução do Diálogo\"
dispatch
echo end
</PRE>
</CODE></BLOCKQUOTE>
<P>
<H3>echo show \"título\" \"Introdução\"</H3>
<P>Isto funciona do mesmo modo que o edit. Ele apresenta o diálogo com os mesmos
argumentos, mas retorna imediatamente. Geralmente é usado com o comando
<A HREF="#newf_gauge">newf_gauge</A>.
<P>
<P>
<H3>dispatch</H3>
<P>Passa o controle para Linuxconf/shellmod e espera pelos resultados.
As variáveis de campo são atualizadas e a variável CODE recebe o valor do
botão selecionado pelo usuário: Pode ser tanto "accept" (aceitar) como
"cancel" (cancelar).
<P>
<H3>echo end</H3>
<P>Isto apaga o diálogo. Ele é removido da tela e esquecido.
Nós editamos freqüentemente o comando end logo após o comando
dispatch. Mas diálogos mais complexos podem utilizar o comando
end após um loop de validação.
<P>
<H3>Um exemplo completo</H3>
<P>
<BLOCKQUOTE><CODE>
<PRE>
#!/usr/bin/shellmod
. /usr/lib/linuxconf/lib/shellmod-lib.sh
main(){
echo DIALOG
echo newf_str name \"Nome de Usuário\"
while true
do
echo edit \"Perguntas ao usuário\" \"Entre com o nome de usuário\"
dispatch
if [ "$CODE" = "cancel" ] ; then
break
elif [ "$name" = "" ] ; then
echo error \"Por favor entre com um nome\"
else
echo notice \"Fazendo algo com a conta do usuário\"
break
fi
done
echo end
}
dispatch
</PRE>
</CODE></BLOCKQUOTE>
<P>
<H2><A NAME="ss3.4">3.4 Construindo um menu</A>
</H2>
<P>Isto é manipulado pelos comandos DIALOG_MENU e new_menuitem.
<P>
<H3>echo DIALOG_MENU</H3>
<P>Não requere nenhum argumento.
<P>
<H3>echo new_menuitem function prompt titulo</H3>
<P>Isto registra mais uma entrada no menu. Cada entrada de menu é associada
com uma função de script (que deve ser definida). O prompt
geralmente é uma palavra-chave. O título é o restante da entrada do menu.
<P>
<H3>echo editmenu \"Título do Menu\" \"Introdução\"</H3>
<P>Isto faz o menu aparecer. É seguido por uma chamada a dispatch.
<P>
<H3>dispatch</H3>
<P>Aqui é onde tudo é realizado para o menu. A função dispatch
será executada até que o usuário selecione o botão "quit".
A função correspondente é chamada sempre que uma entrada de menu
for selecionada. Isto é manipulado transparentemente pela função
dispatch.
<P>Observe que a função dispatch também termina se o usuário selecionar
algum botão opcional (adicionados com o comando button).
Deste modo é possível executar o controle em um loop como o diálogo
do exemplo acima.
<P>
<H3>echo end</H3>
<P>Apaga o menu.
<P>
<H3>Um exemplo completo</H3>
<P>
<BLOCKQUOTE><CODE>
<PRE>
#!/usr/bin/shellmod
. /usr/lib/linuxconf/lib/shellmod-lib.sh
menufunc1(){
echo notice \"menufunc1 selecionado\"
}
menufunc2(){
echo notice \"menufunc2 selecionado\"
}
main(){
echo DIALOG_MENU
echo new_menuitem menufunc1 Select \"Primeira opção\"
echo new_menuitem menufunc2 \"\" \"Segunda opção\"
echo editmenu \"Menu principal\" \"Escolha uma opção\"
dispatch
echo end
}
dispatch
</PRE>
</CODE></BLOCKQUOTE>
<P>
<H2><A NAME="ss3.5">3.5 Gerenciando uma lista de registros</A>
</H2>
<P>
<H3>echo DIALOG_LIST</H3>
<P>DIALOG_LIST é apenas uma variação de um menu. A principal diferença é que
o número da entrada pode ser bem longo. Nesse caso, um diálogo
de filtro será apresentado para restringir o número de registros mostrados.
Você pode então lidar com uma lista muito grande de itens.
<P>DIALOG_LIST não requer nenhum argumento.
<P>
<H3>echo newf_head \"Título da Coluna 1\" \"Título da Coluna 2\" ...</H3>
<P>Você pode definir o cabeçalho da lista. Isto é opcional, mas fica com
um aspecto muito melhor.
<P>
<H3>echo new_menuitem \"Argumentos da função\" \"Valor da Coluna 1\" \"Valor da Coluna 2\" ...</H3>
<P>Funciona como DIALOG_MENU, exceto por nós normalmente fornecermos mais colunas.
Existe uma outra variação quando a função é definida com argumentos.
Observe que este modo pode ser utilizado com DIALOG_MENU da mesma forma. Nós
geralment definimos uma função por entrada de menu e uma função simples para
processar cada registro da lista, usando o argumento para diferenciar o
processamento.
<P>Observe também que você pode usar uma solução mista com o mesmo DIALOG_MENU
ou DIALOG_LIST: você pode utilizar uma função simples para fornecer um
processamento comum para alguns registros e uma função diferente para
gerenciar exceções.
<P>
<H3>echo editmenu \"Título da lista\" \"Introdução\"</H3>
<P>Igual a DIALOG_MENU.
<P>
<H3>dispatch</H3>
<P>Isto se comporta como DIALOG_MENU.
<P>
<H3>echo end</H3>
<P>Isto apaga a lista.
<P>
<H3>Um exemplo completo</H3>
<P>Eis aqui um exemplo real onde nós apresentamos um diretório e
permitimos que o usuário escolha um arquivo para fazer algo com ele.
Nós vemos neste exemplo como é fácil analisar a saída do comando
"<CODE>ls -l</CODE>" e apresentar o nome do arquivo, o tamanho e a data
de revisão em um formato de três colunas.
<BLOCKQUOTE><CODE>
<PRE>
#!/usr/bin/shellmod
. /usr/lib/linuxconf/lib/shellmod-lib.sh
fileshow(){
echo notice \"Processando arquivo $1\"
}
main(){
echo DIALOG_LIST
echo newf_head \"Nome do Arquivo\" Size \"Data de Revisão\"
ls -l $1 | \
(
read total
while read perm count user group size month day hour name
do
echo new_menuitem \"fileshow $name\" $name $size \"$month $day $hour\"
done
)
echo editmenu \"Diretório Atual\" \"Mostra todos os arquivos no diretório atual\"
dispatch
echo end
}
dispatch
</PRE>
</CODE></BLOCKQUOTE>
<P>
<H2><A NAME="ss3.6">3.6 Definindo campos</A>
</H2>
<P>Todos os comandos que definem um campo de diálogo iniciam com o prefixo <CODE>newf_</CODE>.
Nós usamos a mesma ordem de nome e de parâmetro (quando possível) conforme
a API do módulo C++.
<P>O primeiro argumento é sempre o nome da variável shell a qual receberá
o valor entrado pelo usuário. Você utilizará freqüentemente a seguinte
construção para editar (corrigir o valor atual) de uma determinada
variável.
<P>
<BLOCKQUOTE><CODE>
<PRE>
qecho newf_str var "title" "$var"
.
qecho edit ...
dispatch
if [ "$CODE" = "accept" ] ; then
if [ "$var" = "..." ] ;then
.
.
fi
fi
</PRE>
</CODE></BLOCKQUOTE>
<P>
<H2><A NAME="ss3.7">3.7 Lista de comandos</A>
</H2>
<P>Here is the list of all field definition commands:
<P>
<UL>
<LI>
<A HREF="#newf_chk">newf_chk</A></LI>
<LI>
<A HREF="#newf_chkm">newf_chkm</A></LI>
<LI>
<A HREF="#newf_combo">newf_combo</A></LI>
<LI>
<A HREF="#newf_dbl">newf_dbl</A></LI>
<LI>
<A HREF="#newf_enum">newf_enum</A></LI>
<LI>
<A HREF="#newf_gauge">newf_gauge</A></LI>
<LI>
<A HREF="#newf_hexnum">newf_hexnum</A></LI>
<LI>
<A HREF="#newf_list">newf_list</A></LI>
<LI>
<A HREF="#newf_num">newf_num</A></LI>
<LI>
<A HREF="#newf_pass">newf_pass</A></LI>
<LI>
<A HREF="#newf_radio">newf_radio</A></LI>
<LI>
<A HREF="#newf_slider">newf_slider</A></LI>
<LI>
<A HREF="#newf_str">newf_str</A></LI>
<LI>
<A HREF="#newf_title">newf_title</A></LI>
</UL>
<P>
<P>
<P>
<H3><A NAME="newf_chk"></A> echo newf_chk var \"Título do campo\" \"Valor inicial 0 ou 1\" \"Título do sufixo\" </H3>
<P>Define um campo de caixa de verificação (lig/des ou sim/não). A variável var
será definida como 0 ou 1. Este campo tem dois títulos. Um na esquerda da
caixa de verificação e um na direita. No Linuxconf, isto é freqüentemente
usado da seguinte maneira:
<P>
<BLOCKQUOTE><CODE>
<PRE>
A seguinte característica [ ] está selecionada
</PRE>
</CODE></BLOCKQUOTE>
<P>
<H3>Variações da sintaxe de newf_chk</H3>
<P>Quando você usar newf_chk, você deve passar valores 0 ou 1. A variável edit
receberá esse valor como 0 ou 1. Isto não é muito útil, já que, com freqüência,
scripts shell lidam com diferentes tipos de valores booleanos. Por exemplo,
um script tratando com um servidor SQL pode se deparar com valores como Y e N.
Para evitar a tradução de um sistema para o outro, a sintaxe do valor inicial
foi expandida.
<P>
<UL>
<LI>Para facilitar as coisas, o shellmod aceita como valor selecionado
qualquer coisa entre 1, Y e Yes (maíusculas ou minúsculas). A menos
que o contrário seja explicitado, estes valores serão traduzidos para 1.
Todo o restante será traduzido para 0.</LI>
<LI>Utilizando um formato especial de três campos, pode-se especificar o valor
real e o dicionário utilizado para interpretá-lo. O valor deve ser
especificado da seguinte maneira:
<BLOCKQUOTE><CODE>
<PRE>
valor:valor_lig:valor_des
</PRE>
</CODE></BLOCKQUOTE>
Deste modo, se a sua aplicação está lidando com valores ON/OFF, você pode
especificar o valor inicial desta forma:
<BLOCKQUOTE><CODE>
<PRE>
$var:ON:OFF
</PRE>
</CODE></BLOCKQUOTE>
Não só os valores ON e OFF serão aceitos pelo interpretador, como
também o resultado final será enviado ao script usando uma daquelas
palavras.</LI>
</UL>
<P>
<H3><A NAME="newf_chkm"></A> echo newf_chkm var \"título do campo\" \"valor numérico inicial\" \"valor1\" \"valor2\" ... </H3>
<P>Configuração de campos de seleção múltipla utilizando caixas de verificação.
As caixas são apresentadas horizontalmente. Eis um exemplo seguido do campo
produzido em modo texto:
<P>
<BLOCKQUOTE><CODE>
<PRE>
echo newf_chkm sel \"Qual posição\" 1 esquerda centro direita
</PRE>
</CODE></BLOCKQUOTE>
<P>This produces:
<P>
<BLOCKQUOTE><CODE>
<PRE>
Qual posição ( ) esquerda (o) centro ( ) direita
</PRE>
</CODE></BLOCKQUOTE>
<P>A variável var conterá o índice numérico do item selecionado,
iniciando em 0.
<P>
<H3><A NAME="newf_combo"></A> echo newf_combo var \"título do campo\" \"Valor inicial\" </H3>
<P>Configura uma linha simples + campo seletor. O usuário será capaz de selecionar um valor
dentre uma lista de valores ou entrar com um outro manualmente. A variável var irá
conter o valor textual seja ele digitado ou selecionado.
<P>newf_combo é usado com o comando comboitem. Você configura antes o campo
combo e então você passa um por um os valores possíveis utilizando
comboitem. Observe que os valores são seguidos por um texto descritivo
(opcional). Segue abaixo um código exemplo:
<P>
<BLOCKQUOTE><CODE>
<PRE>
echo newf_combo port \"Qual porta\" ttyS1
echo comboitem ttyS0 \"COM1 no DOS\"
echo comboitem ttyS1 \"COM2 no DOS\"
echo comboitem ttyS2 \"COM3 no DOS\"
</PRE>
</CODE></BLOCKQUOTE>
<P>A variável $port conterá o valor ttyS0, ttyS1, ttyS2 ou qualquer coisa
que o usuário digite. Veja
<A HREF="#newf_enum">newf_enum</A>
e
<A HREF="#newf_list">newf_list</A> para variações deste campo
de entrada.
<P>
<H3><A NAME="newf_dbl"></A> echo newf_dbl var \"título do campo\" \"valor numérico inicial\" numero-de-casas </H3>
<P>Configura um campo de entrada numérico com notação decimal. Funciona
como <CODE>
<A HREF="#newf_num">newf_num</A></CODE>
exceto por permitir um ponto decimal. O parâmetro número-de-casas
controla o número de dígitos permitidos após o ponto decimal bem como a
formatação do campo.
<P>
<H3><A NAME="newf_enum"></A> echo newf_enum var \"título do campo\" \"Valor numérico inicial\" </H3>
<P>Configura um campo seletor. O usuário será capaz de selecionar um valor
dentre uma lista de seleção. A variável var conterá o índice dos itens
selecionados. O usuário é limitado a escolher um único item da lista.
<P>newf_enum é usado com o comando enumitem. Você configura primeiro o
campo enum e então passa um por um os valores possíveis utilizando
enumitem. Segue abaixo um código exemplo:
<P>
<BLOCKQUOTE><CODE>
<PRE>
echo newf_enum no \"Qual porta\" 1
echo enumitem ttyS0 \"COM1 no DOS\"
echo enumitem ttyS1 \"COM2 no DOS\"
echo enumitem ttyS2 \"COM3 no DOS\"
</PRE>
</CODE></BLOCKQUOTE>
<P>A variável $no conterá o valor 0, 1 ou 2. Veja
<A HREF="#newf_combo">newf_combo</A> e
<A HREF="#newf_list">newf_list</A>
para variações deste campo de entrada.
<P>
<H3><A NAME="newf_gauge"></A> echo newf_gauge ID \"título do campo\" \"Valor decimal inicial\" \"Valor máximo\" </H3>
<P>Configura um indicador visual de medida, geralmente usada para mostrar o progresso
de execução de um processo (carregamento, instalação). O estado do indicador
é alterado à cada chamada a este comando. A primeira chamada define o campo,
as próximas atualizam o indicador. Este widget é geralmente utilizado com o comando
"show" de forma que o script nunca pára no estado "edit".
Eis aqui um pequeno exemplo:
<P>
<BLOCKQUOTE><CODE>
<PRE>
echo DIALOG
qecho newf_gauge ID "Status" 0 10
qecho show "Status" ""
i=0
while [ "$i" != "10" ] ; do
i=`expr $i + 1`
sleep 1
qecho newf_gauge ID "Status" $i 10
qecho show "Status" ""
done
</PRE>
</CODE></BLOCKQUOTE>
<P>
<H3><A NAME="newf_hexnum"></A> echo newf_hexnum var \"título do campo\" \"Valor hexadecimal inicial\" </H3>
<P>Configura um campo de entrada numérico (inteiro). Funciona como
<CODE>
<A HREF="#newf_num">newf_num</A></CODE>
mas aceita dígitos numéricos e hexadecimais.
<P>
<H3><A NAME="newf_list"></A> echo newf_list var \"título do campo\" \"Valor inicial\" </H3>
<P>Configura um campo seletor. O usuário poderá selecionar um valor
dentre uma lista. A variável var irá conter o valor textual
selecionado.
<P>newf_list é utilizado com o comando listitem. Você primeiro configura
o campo de lista e então você passa um por um todos os valores
possíveis usando listitem. Observe que os valores são seguidos por um
texto descritivo (opcional).
Segue um código exemplo:
<P>
<BLOCKQUOTE><CODE>
<PRE>
echo newf_list port \"Qual porta\" ttyS1
echo listitem ttyS0 \"COM1 no DOS\"
echo listitem ttyS1 \"COM2 no DOS\"
echo listitem ttyS2 \"COM3 no DOS\"
</PRE>
</CODE></BLOCKQUOTE>
<P>A variável $port conterá o valor ttyS0, ttyS1 ou ttyS2.
Veja
<A HREF="#newf_enum">newf_enum</A>
e
<A HREF="#newf_combo">newf_combo</A>
para variações neste campo de entrada.
<P>
<H3><A NAME="newf_num"></A> echo newf_num var \"título do campo\" \"Valor numérico inicial\" </H3>
<P>Configura um campo de entrada numérico (inteiro). Funciona como <CODE>newf_str</CODE>
mas aceita apenas um dígito.
<P>
<H3><A NAME="newf_pass"></A> echo newf_pass var \"título do campo\" \"Valor inicial\" </H3>
<P>Configura um campo de senha. Funciona como o campo <CODE>newf_str</CODE> exceto
pela entrada não ser ecoada (digitação invisível).
<P>
<H3><A NAME="newf_radio"></A> echo newf_radio var \"título do campo\" valor-numérico valor-da-instância \"título do sufixo\" </H3>
<P>Configura um campo de botão de rádio. Vários campos de botão de rádio devem
ser definidos para cada seleção possível. Todos os botões de rádio que compartilham
a mesma variável de entrada (var, acima) operam juntos: ligar um desliga o outro
e vice-versa. A variável var conterá o valor numérico do campo de botão de rádio
selecionado.
<P>Botões de rádio selecionados podem ser colocados em qualquer lugar em um diálogo.
Eles não precisam estar em seqüência nem mesmo na mesma página do diálogo.
<P>
<H3><A NAME="newf_slider"></A> echo newf_slider var \"título do campo\" \"Valor decimal inicial\" \"Valor mínimo\" \"Valor máximo\" </H3>
<P>Isto funciona como newf_num, para editar um valor decimal. Mas é
mostrado como um botão deslizante. Os valores mínimo e máximo representam as
margens esquerda e direita do botão deslizante.
<P>
<BLOCKQUOTE><CODE>
<PRE>
qecho newf_slider var "Hora de Reunião" 15 9 16
</PRE>
</CODE></BLOCKQUOTE>
<P>
<H3><A NAME="newf_str"></A> echo newf_str var \"título do campo\" \"Valor inicial\" </H3>
<P>Configura uma entrada de texto de uma linha.
<P>
<H3><A NAME="newf_title"></A> echo newf_title "Título da Página" level "Título Esquerdo" "Título em modo texto" </H3>
<P>Isto não é um campo de entrada, mas é uma forma de organizar um grande diálogo
em uma seção. O resultado final é bem diferente em modo gráfico do que em em
texto ou HTML. Em modo gráfico, isto criará um diálogo em um bloco de notas
e cada newf_title define uma página do bloco de notas.
<P>O primeiro argumento, o título da página, é usado apenas em modo gráfico.
<P>O segundo argumento é um número e representa o nível do bloco de notas. Isto
permite diálogos muito complexos com blocos de notas dentro de blocos de notas.
Em modos texto e HTML mode, este argumento não tem efeito.
<P>
<UL>
<LI>Um valor de 0 adiciona uma divisão horizontal entre dois campos.
o "Título em modo texto" é centrado nesta divisão.</LI>
<LI>Um valor de 1 cria o primeiro nível do bloco de notas. Um valor de 2
cria um sub-bloco de notas com o atual.</LI>
</UL>
<P>O terceiro argumento, título esquerdo, é utilizado apenas em modo texto e HTML.
Ele coloca um pequeno título à esquerda dos campos de entrada.
<P>O último argumento, Título em modo texto, aparece centrado entre dois campos
de entrada.
<P>
<H2><A NAME="ss3.8">3.8 Adicionando botões</A>
</H2>
<P>Você pode adicionar botões opcionais usando simplesmente o comando button.
Ele requer dois argumentos. O primeiro é a ID (identificação) do botão que será
passada ao script utilizando a variável CODE. O segundo é o rótulo (título)
do botão. Segue abaixo um exemplo:
<P>
<BLOCKQUOTE><CODE>
<PRE>
echo DIALOG
echo newf_str name \"Nome de usuárioe\" $name
echo button Add \"Adicionar novo usuário\"
echo edit "title" \"Gerenciamento de usuários\"
dispatch
echo end
if [ "$CODE" = "Add" ] ; then
# Adicionando um novo usuário
elif [ "$CODE" = "accept" ] ; then
# Inspecionando um registro de usuário
fi
</PRE>
</CODE></BLOCKQUOTE>
<P>
<H2><A NAME="ss3.9">3.9 Configura o campo atual de entrada</A>
</H2>
<P>O código de operação "setcurfield" coloca o foco do teclado em um campo específico.
Você deve passar a ID (identificação) do campo como um argumento simples. Eis um exemplo:
<P>
<BLOCKQUOTE><CODE>
<PRE>
qecho DIALOG
qecho newf_str uid "ID de Usuário"
qecho newf_str name "Nome"
qecho newf_str phone "Nome"
qecho setcurfield name
qecho edit "exemplo" "O foco agora está no nome"
dispatch
echo end
</PRE>
</CODE></BLOCKQUOTE>
<P>
<HR>
<A HREF="intro-4.html">Next</A>
<A HREF="intro-2.html">Previous</A>
<A HREF="intro.html#toc3">Contents</A>
</BODY>
</HTML>
|
