summaryrefslogtreecommitdiffstats
path: root/tde-i18n-pt/docs/kdewebdev/kommander/widgets.docbook
diff options
context:
space:
mode:
Diffstat (limited to 'tde-i18n-pt/docs/kdewebdev/kommander/widgets.docbook')
-rw-r--r--tde-i18n-pt/docs/kdewebdev/kommander/widgets.docbook390
1 files changed, 390 insertions, 0 deletions
diff --git a/tde-i18n-pt/docs/kdewebdev/kommander/widgets.docbook b/tde-i18n-pt/docs/kdewebdev/kommander/widgets.docbook
new file mode 100644
index 00000000000..795e4ab70d2
--- /dev/null
+++ b/tde-i18n-pt/docs/kdewebdev/kommander/widgets.docbook
@@ -0,0 +1,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>