summaryrefslogtreecommitdiffstats
path: root/tde-i18n-pt/docs/tdewebdev/kommander/widgets.docbook
blob: 795e4ab70d2a1ae2528ee19480968a7bd46ad9db (plain)
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
<?xml version="1.0"  encoding="UTF-8" ?>

<sect1 id="widgets">
<sect1info>
<title
>Elementos</title>
<authorgroup>
<author
><firstname
></firstname
> <surname
></surname
> <affiliation
><address
> <email
></email>
</address
></affiliation>
</author>

<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>jncp@netcabo.pt</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 

</authorgroup>
</sect1info>

<title
>Elementos</title>

<para
>Os blocos de construção de uma janela do &kommander; são os elementos gráficos ou 'widgets'. Eles são como qualquer um dos elementos gráficos do Qt; e do &kde;, excepto no facto de terem alguma funcionalidade extra, que lhes permite ter uma <quote
>associação de texto</quote
>. O texto é associado com um estado do elemento gráfico ou com o seu 'slot' de população. O número de estado depende do elemento gráfico. Se um elemento só tiver um estado, este é chamado de 'estado por omissão'. </para>

<para
>Texto do elemento blá blá</para>

<para
>A janela tem dois estados especiais para o texto do &kommander;. Eles são o Initiate e o Destroy. Estes são executados quando a janela é inicializada e quando é destruída. Estes protegem contra situações conhecidos por <quote
>race conditions</quote
> (condições de corrida) e significam que você não precisa de nenhuns procedimentos especiais ao fechar para 'manter a casa arrumada'.</para>


<variablelist>
<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="buttongroup.png" format="PNG"/>
</imageobject
></inlinemediaobject
> ButtonGroup </term>
<listitem>
<para
>Um elemento contentor para organizar os botões num grupo. Poderá ser definido um título opcional com a propriedade 'title'. O contorno da área poderá ser ajustado com a propriedade 'lineWidth'. O grupo de botões poderá ser exclusivo se disser que a propriedade 'exclusive' é verdadeira. Isto significa que, quando um botão está carregado, todos os outros ficarão desligados, com a excepção dos RadioButton's, os quais são sempre mutuamente exclusivos, mesmo que o grupo o não seja. Estes botões poderão deixar de ser exclusivos com a propriedade 'radioButtonExclusive'. (Não é certo se esta propriedade funciona de facto.) </para>
<para
>O ButtonGroup tem um estado, o estado por omissão.</para>
<para
>O texto do elemento de um ButtonGroup são as associações de texto para cada um dos botões, pela ordem que aparecem no ButtonGroup. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="checkbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> CheckBox </term>
<listitem>
<para
>Um botão que poderá ser ligado e desligado. Também poderá ser semi-ligado se a propriedade 'tristate' estiver activada. A legenda associada ao CheckBox é definida na propriedade 'text'. Se activar a propriedade 'checked', ficará com o elemento ligado inicialmente. </para>
<para
>Um CheckBox tem 3 estados: 'checked' (ligado), 'semichecked' (semi-ligado) e 'unchecked' (desligado). </para>
<para
>O texto do elemento CheckBox é o valor da propriedade 'text'. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="pushbutton.png" format="PNG"/>
</imageobject
></inlinemediaobject
> CloseButton </term>
<listitem>
<para
>Um botão que, quando for carregado, executa a sua associação de texto e fecha então a janela. O texto no botão é definido com a propriedade 'text'. O resultado da associação de texto será emitido para o 'stdout' se a propriedade 'writeStdout' estiver activa. O botão poderá ser a acção por omissão para a janela, se a propriedade 'default' for verdadeira. </para>
<para
>O CloseButton tem um estado, o predefinido. </para>
<para
>Não existe nenhum texto do elemento associado a um CloseButton. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="combobox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> ComboBox </term>
<listitem>
<para
>O ComboBox é um elemento de selecção que combina um botão com um menu. Ele mostra a escolha actual do utilizador, a partir de uma lista de opções, num espaço mínimo. Os itens são adicionados à lista com a janela de edição. Se a propriedade 'editable' for verdadeira, o utilizador poderá indicar textos arbitrários. </para>
<para
>O ComboBox tem um estado, o por omissão. </para>
<para
>O texto do elemento para uma ComboBox é o texto do item seleccionado. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="pushbutton.png" format="PNG"/>
</imageobject
></inlinemediaobject
> ExecButton </term>
<listitem>
<para
>Um botão que, quando for carregado, executa a sua associação de texto. A legenda do botão é definida com a propriedade 'text'. O resultado da associação de texto será emitido no 'stdout', se a propriedade 'writeStdout' for verdadeira. O botão poderá ser a acção por omissão, se a propriedade 'default' for verdadeira. </para>
<para
>O ExecButton tem um estado, o por omissão. </para>
<para
>Não existe nenhum texto do elemento gráfico associado ao ExecButton. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="lineedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> FileChooser </term>
<listitem>
<para
>O elemento FileChooser combina uma LineEdit com um botão que, quando carregado, irá apresentar ao utilizador uma janela para poder seleccionar ficheiros/pastas. O ficheiro/pasta seleccionado é guardado no LineEdit. O tipo do FileChooser é definido com a propriedade 'selectionType'. Os tipos disponíveis são o Open, o Save e o Directory. Podem ser seleccionados vários ficheiros/pastas se a propriedade 'selectionOpenMultiple' for verdadeira. Poderá ser definido um título para o  FileChooser com a propriedade 'selectionCaption'. Isto é mostrado como o título da janela. Se não for indicado nenhum título, o tipo de selecção será mostrado no título. Os ficheiros mostrados na janela poderão ser limitado com a propriedade 'selectionFilter'. </para>
<para
>O FileChooser tem um estado, o por omissão. </para>
<para
>O texto do elemento FileChoose é o texto contido no LineEdit (o ficheiro seleccionado pelo utilizador). </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="groupbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> GroupBox </term>
<listitem>
<para
>Um elemento que contém outros elementos. O contorno da sua área é ajustado com a propriedade 'lineWidth'. Pode ser adicionado um título com a propriedade 'title'. </para>
<para
>O GroupBox tem um estado, o por omissão. </para>
<para
>O texto do elemento GroupBox são as associações de texto de cada um dos elementos que ele contém, combinados em conjunto. Eles estarão na ordem pela qual aparecem no GroupBox. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="lineedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> LineEdit </term>
<listitem>
<para
>Um elemento LineEdit é um campo de texto de uma linha. Permite ao utilizador indicar e modificar uma única linha de texto. O texto inicial do campo pode ser definido com a propriedade 'text'. O elemento poderá ser configurado como sendo apenas para leitura com a propriedade 'readOnly'. Existem três modos para o elemento: Normal, NoEcho e Password. O modo é definido com a propriedade 'echoMode'. </para>
<para
>O LineEdit tem um estado, o por omissão. </para>
<para
>O texto do elemento LineEdit é o texto escrito no próprio campo. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="listbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> ListBox </term>
<listitem>
<para
>Um elemento ListBox contém uma lista de itens seleccionáveis. Normalmente, só está um ou zero elementos seleccionados. Este comportamento poderá ser alterado com a propriedade 'selectionMode'. Os itens são adicionados à ListBox usando a janela de edição. </para>
<para
>Uma ListBox só tem um estado, o por omissão. </para>
<para
>O texto do elemento para uma ListBox são os itens contidos na ListBox. O @selectedWidgetText irá devolver apenas os itens que estão seleccionados de momento. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="listview.png" format="PNG"/>
</imageobject
></inlinemediaobject
> ListView </term>
<listitem>
<para
>Este elemento não está activo no &kommander;. É funcionalmente igual ao elemento em árvore, por isso baseie-se nisso. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="pixlabel.png" format="PNG"/>
</imageobject
></inlinemediaobject
> PixmapLabel </term>
<listitem>
<para
>Um elemento simples que contém uma legenda de texto ou imagem. A imagem a mostrar é definida na propriedade 'pixmap'. O texto é definido na propriedade 'text'. Só uma destas propriedades poderá ser definida ao mesmo tempo (pelo menos o editor recusa configurar ambas ao mesmo tempo). Se o 'scaledContents' for verdadeiro, então a janela será ajustada para caber no elemento. O formato do texto poderá ser definido com a propriedade 'textFormat'. </para>
<para
>Este elemento não está activo no &kommander; e não tem nenhuns estados ou texto associado. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="radiobutton.png" format="PNG"/>
</imageobject
></inlinemediaobject
> RadioButton </term>
<listitem>
<para
>Um botão que poderá ser ligado e desligado, usado normalmente no ButtonGroup para criar uma opção exclusiva. A legenda associada ao CheckBox é definida na propriedade 'text'. Se activar a propriedade 'checked', ficará com o elemento ligado inicialmente. Se todos os RadioButton's de um ButtonGroup tiverem a propriedade 'checked' verdadeira, então será usado o último botão. </para>
<para
>O RadioButton tem 2 estados: ligado e desligado. </para>
<para
>Não existe nenhum texto de elemento associado a um RadioButton. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="richtextedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> RichTextEditor </term>
<listitem>
<para
>Este elemento contém um editor de texto que permite alguma formatação simples de texto. </para>
<para
>O RichTextEditor tem um estado, o por omissão. </para>
<para
>O texto do elemento RichTextEditor é o texto contido no editor, num formato de texto rico. O texto seleccionado poderá ser devolvido com o @selectedWidgetText. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="spinbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> SpinBoxInt </term>
<listitem>
<para
>Um elemento que permite ao utilizador alterar um valor inteiro, carregando quer nas setas para cima ou para baixo ou indicar um valor no campo de texto. Os valores mínimo e máximo poderão ser definidos com as propriedades 'minValue' e 'maxValue'. A propriedade 'specialValueText' é usada para configurar um valor de texto que será mostrado em vez do valor mínimo. </para>
<para
>Este elemento só tem um estado, o por omissão. </para>
<para
>O texto do elemento SpinBoxInt é o número mostrado de momento. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="frame.png" format="PNG"/>
</imageobject
></inlinemediaobject
> SubDialog </term>
<listitem>
<para
>Um botão que corre outra janela do &kommander;, quando for carregado. A janela a correr é definida na propriedade 'kmdrFile'. Se a propriedade 'default' for verdadeira, a janela será executada, quando o Enter for carregado enquanto a janela está em primeiro plano. Pensa-se que poderá também ser usada como contentor (possuir outros elementos dentro dela). </para>
<para
>O SubDialog tem um estado, o por omissão. </para>
<para
>O texto do elemento SubDialog é a associação de texto da janela que executa. </para>
<note
><para
>Este pretendia conter a janela, mas foi desactualizado com o novo conceito de projecto. Deverá ficar à mesma com o <function
>@dialog()</function
> no seu texto do &kommander; ou deverá ser eliminado? Tal como está, fica incorrecto.</para
></note>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="tabwidget.png" format="PNG"/>
</imageobject
></inlinemediaobject
> TabWidget </term>
<listitem>
<para
>Um elemento que contém várias páginas, que por sua vez podem conter outros elementos. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="multilineedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> TextEdit </term>
<listitem>
<para
>Um campo de texto simples em várias linhas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="label.png" format="PNG"/>
</imageobject
></inlinemediaobject
> TextLabel </term>
<listitem>
<para
>Um elemento simples que contém algum texto. Este elemento permite-lhe também definir uma imagem. Ok, o editor diz que eles são ambos QLabel's. Porque é que existem 2 elementos que parecem fazer a mesma coisa, mas com nomes diferentes? - Isto pretende ser corrigido na Alpha 7. </para>
<para
>Desde a versão Alpha 6 este item está parcialmente activado e poderá ser configurado através de chamadas de DCOP externas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="listview.png" format="PNG"/>
</imageobject
></inlinemediaobject
> TreeWidget </term>
<listitem>
<para
>Um elemento que oferece uma lista com uma estrutura em árvore. Este elemento gráfico está agora completamente activo para adicionar e remover itens, desde a versão Alpha 6. Você poderá adicionar itens-filhos e dados em várias colunas. A limitação actual é que você não poderá modificar as colunas. Para adicionar um item-filho, use o <quote
>/</quote
> como separador. Para adicionar dados nas colunas, use o carácter de tabulação<quote
>\t</quote
> entre as colunas. </para>
</listitem>
</varlistentry>
</variablelist>
</sect1>