<?xml version="1.0"  encoding="UTF-8" ?>

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

&traductor.Antoni.Bella; 

</authorgroup>
</sect1info>

<title
>Estris</title>

<para
>Els blocs de construcció d'un diàleg de &kommander; són els estris. Són com qualsevol altre control a les biblioteques &Qt; i &kde;, excepte si no tenen alguna funcionalitat extra que els permeti tenir una <quote
>associació de text</quote
>. El text s'associa amb un estat de l'estri o la seva ranura «populate». El nombre d'estats dependrà de l'estri. Si un estri només té un estat, aquest estat s'anomenarà «default» (omissió). </para>

<para
>Text de l'estri bla bla</para>

<para
>El diàleg té dos estats especials per al text de &kommander;. Es «Initiate» (iniciar) i «Destroy» (destruir). S'executen quan s'inicia i quan es destrueix el diàleg. Aquests protegeixen contra situacions concebudes per <quote
>condicions de raça</quote
> (condicions d'execució), el qual vol dir que no es requereix cap procediment especial de tancament per gestionar la neteja general.</para>


<variablelist>
<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="buttongroup.png" format="PNG"/>
</imageobject
></inlinemediaobject
> ButtonGroup </term>
<listitem>
<para
>Un contenidor per organitzar els botons en un grup. Es pot establir un títol opcional utilitzant la propietat «title» (títol). El marc es pot ajustar amb la propietat «lineWidth» (amplada de la línia). El grup de botons es pot establir a «exclusive» (exclusiu) establint aquesta propietat a «true» (cert). Així doncs, en fer clic sobre un botó d'alternança els altres s'establiran a «off» (desactivat) amb l'excepció dels botons d'opció que sempre són mútuament excloents, encara que el grup no sigui «exclusive» (exclusiu). Els botons d'opció es poden configurar per «non-exclusive» (no exclusiu) utilitzant la propietat «radioButtonExclusive». (No estic segur que aquesta propietat funcioni realment). </para>
<para
>ButtonGroup té un estat, «default» (omissió).</para>
<para
>El text de l'estri per a un ButtonGroup són les associacions de text per a cadascun dels botons en l'ordre en què apareixen en el ButtonGroup. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="checkbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> CheckBox </term>
<listitem>
<para
>Un botó que es pot estar marcat amb «on» (activat) i «off» (desactivat). També pot estar «semi-checked» (semi-marcat) si la propietat «tristate» (triestat) s'estableix a «true» (cert). L'etiqueta associada amb el control CheckBox s'estableix en la propietat «text». En establir la propietat «checked» (marcat), la CheckBox es marcarà inicialment. </para>
<para
>CheckBox té 3 estats, «checked» (marcat), «semichecked» (semi-marcat) i «unchecked» (sense marcar). </para>
<para
>El text de l'estri per a un control CheckBox és el valor de la propietat text. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="pushbutton.png" format="PNG"/>
</imageobject
></inlinemediaobject
> CloseButton </term>
<listitem>
<para
>Un botó que quan es fa clic, executa la seva associació de text i després tanca el diàleg. L'etiqueta sobre el botó s'estableix amb la propietat «text». La sortida de l'associació de text (com dir això) es mostrarà a la sortida estàndard si la propietat «writeStdout» (escriu a la sortida estàndard) s'estableix a «true» (cert). El botó pot ser l'acció per omissió per al diàleg si la propietat «default» (omissió) s'estableix a «true» (cert). </para>
<para
>CloseButton té un estat, «default» (omissió). </para>
<para
>No hi ha cap text de l'estri associat amb un CloseButton. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="combobox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> ComboBox </term>
<listitem>
<para
>ComboBox és un estri de selecció que combina un botó i un menú emergent. Mostra l'elecció actual de l'usuari a partir d'una llista d'opcions en un espai mínim. Els elements s'afegeixen a la llista utilitzant la finestra d'edició. Si la propietat «editable» s'estableix a «true» (cert), l'usuari podrà introduir cadenes arbitràries. </para>
<para
>ComboBox té un estat, «default» (omissió). </para>
<para
>El text de l'estri per a una ComboBox és el text de l'element seleccionat. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="pushbutton.png" format="PNG"/>
</imageobject
></inlinemediaobject
> ExecButton </term>
<listitem>
<para
>Un botó que quan es fa clic, executa la seva associació de text. L'etiqueta sobre el botó s'estableix amb la propietat «text». La sortida de l'associació de text (com dir això) es mostrarà a la sortida estàndard si la propietat «writeStdout» (escriu a la sortida estàndard) s'estableix a «true» (cert). El botó pot ser l'acció per omissió per al diàleg si la propietat «default» (omissió) s'estableix a «true» (cert). </para>
<para
>ExecButton té un estat, «default» (omissió). </para>
<para
>No hi ha text de l'estri associat amb ExecButton. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="lineedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> FileChooser </term>
<listitem>
<para
>L'estri FileChooser combina una LineEdit amb un botó que en fer clic presentarà a l'usuari un diàleg per a la selecció de fitxers o carpetes. El fitxer o carpeta seleccionat s'emmagatzema a la LineEdit. El tipus del FileChooser s'estableix amb la propietat «selectionType». Els tipus disponibles són: «Open» (obre), «Save» (desa) i «Directory» (directori). Es poden seleccionar múltiples fitxers o carpetes si la propietat «selectionOpenMutliple» s'estableix a «true» (cert). Es pot establir un títol per a FileChooser amb la propietat «selectionCaption». Es mostrarà com al títol de la finestra de diàleg. Si no s'especifica un títol, es mostrarà el tipus de selecció com el títol. Els fitxers que es mostren en el diàleg es podran limitar utilitzant la propietat «selectionFilter». </para>
<para
>FileChooser té un estat, «default» (omissió). </para>
<para
>El text de l'estri per a un FileChooser és el text contingut a LineEdit (el fitxer seleccionat per l'usuari). </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="groupbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> GroupBox </term>
<listitem>
<para
>Un estri contenidor que conté altres estris. El marc s'ajusta amb la propietat «lineWidth» (amplada de la línia). Es pot afegir un títol establint la propietat «title» (títol). </para>
<para
>GroupBox té un estat, «default» (omissió). </para>
<para
>El text de l'estri per a GroupBox són les associacions de text de cadascun dels estris que conté «combined» (combinat). Estaran en l'ordre en què apareixen a l'interior del GroupBox. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="lineedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> LineEdit </term>
<listitem>
<para
>Un estri LineEdit és un editor de text d'una línia. Permet a l'usuari introduir i modificar una sola línia de text. El text inicial de l'editor es pot establir en la propietat «text». L'estri es pot configurar com de només lectura amb la propietat «readOnly». Hi ha 3 modes per a l'estri, «Normal», «NoEcho» (sense eco) i «Password» (contrasenya). El mode s'estableix amb la propietat «echoMode». </para>
<para
>LineEdit té un estat, «default» (omissió). </para>
<para
>El text de l'estri per a LineEdit és el text que figura en l'editor. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="listbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> ListBox </term>
<listitem>
<para
>Un estri ListBox proporciona una llista d'elements seleccionables. Normalment hi ha seleccionats un o cap element. Aquest comportament es pot modificar amb la propietat «selectionMode». Els elements s'afegeixen a la ListBox utilitzant la finestra d'edició. </para>
<para
>ListBox només té 1 estat, «default» (omissió). </para>
<para
>El text de l'estri per a una ListBox seran els elements continguts en la ListBox. @selectedWidgetText només retornarà els elements actualment seleccionats. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="listview.png" format="PNG"/>
</imageobject
></inlinemediaobject
> ListView </term>
<listitem>
<para
>Aquest estri ara estarà &kommander; activat. La seva funcionalitat és la mateixa que a l'estri en arbre, de manera que pugueu consultar la referència completa. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="pixlabel.png" format="PNG"/>
</imageobject
></inlinemediaobject
> PixmapLabel </term>
<listitem>
<para
>Un estri senzill que conté una imatge o una etiqueta de text. El mapa de píxels a mostrar s'estableix en la propietat «pixmap» (mapa de píxels). El text s'estableix a la propietat «text». Només es pot establir una d'aquestes propietats alhora (això penso, ja que no puc obtenir l'editor per configurar tots dos alhora). Si «scaledContents» s'estableix a «true» (cert), la imatge s'escalarà per ajustar-se a la mida de l'estri. El format del text es pot establir amb la propietat «textFormat» (format del text). </para>
<para
>Aquest estri no està activat al &kommander; i no conté cap estat o text d'estri. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="radiobutton.png" format="PNG"/>
</imageobject
></inlinemediaobject
> RadioButton </term>
<listitem>
<para
>Un botó que pot estar «checked» (marcat) o «unchecked» (sense marcar), habitualment utilitzat en el ButtonGroup per fer una elecció «exclusive» (exclusiva). Es pot establir una etiqueta associada al botó a la propietat «text». Un botó pot estar «initialized» (inicialitzat) per comprovar si estableix la propietat «checked» (marcat) a «true» (cert). Si tots els RadioButton en un ButtonGroup tenen establerta la propietat «checked» (marcat) a «true» (cert), llavors l'últim botó serà el que estarà «checked» (marcat). </para>
<para
>RadioButton té 2 estats «checked» (marcat) i «unchecked» (sense marcar). </para>
<para
>No n'hi ha cap text de l'estri associat amb un RadioButton. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="richtextedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> RichTextEditor </term>
<listitem>
<para
>Aquest estri proporciona un editor de text que permet el format de text simple. </para>
<para
>RichTextEditor té un estat, «default» (omissió). </para>
<para
>El text de l'estri per a RichTextEditor serà el text contingut an l'editor en el format de text enriquit. El text seleccionat es podrà retornar amb @selectedWidgetText. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="spinbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> SpinBoxInt </term>
<listitem>
<para
>Un estri que permet a l'usuari canviar un valor sencer, ja sigui prement les tecles de fletxa amunt i avall per introduir un valor en el quadre. Els valors mínims i màxims per a l'estri es poden configurar amb les propietats «minValue» i «maxValue». La propietat «specialValueText» s'utilitza per establir un valor de text que es mostrarà en lloc del valor mínim. </para>
<para
>SpinBoxInt només té un estat, «default» (omissió). </para>
<para
>El text de l'estri per a un SpinBoxInt és el sencer mostrat actualment. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="frame.png" format="PNG"/>
</imageobject
></inlinemediaobject
> SubDialog </term>
<listitem>
<para
>Un botó que quan es prem executa un altre diàleg de &kommander;. Aquest diàleg s'estableix a la propietat «kmdrFile» (fitxer kmdr). Si la propietat «default» (omissió) s'estableix a «true» (cert), el diàleg s'executarà si es prem &Intro; mentre el diàleg té el focus. Penso que també es pot utilitzar com un contenidor. He de jugar una mica més amb això. </para>
<para
>SubDialog té un estat, «default» (omissió). </para>
<para
>El text de l'estri de SubDialog és l'associació de text del diàleg que executa. </para>
<note
><para
>Això pretén contenir el diàleg, el qual està obsolet amb el nou concepte de projecte. Hauríem de deixar-lo amb <function
>@dialog()</function
> en el seu text de &kommander; o desfer-nos-en? No està bé tal com està.</para
></note>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="tabwidget.png" format="PNG"/>
</imageobject
></inlinemediaobject
> TabWidget </term>
<listitem>
<para
>Un estri que proporciona múltiples pestanyes que a la seva vegada poden contenir altres estris. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="multilineedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> TextEdit </term>
<listitem>
<para
>Un simple editor de text multi-línia. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="label.png" format="PNG"/>
</imageobject
></inlinemediaobject
> TextLabel </term>
<listitem>
<para
>Un estri senzill que conté una peça de text. Aquest estri també permet establir un mapa de píxels. Bé, l'editor diu que tots dos són QLabels. Per què tenim dos estris que semblen ser la mateixa cosa, però amb noms diferents? -Programat per a solucionar-ho a alfa 7-. </para>
<para
>A partir d'alfa 6 aquest estri està activat parcialment i es pot ajustar amb crides &DCOP; externes. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="listview.png" format="PNG"/>
</imageobject
></inlinemediaobject
> TreeWidget </term>
<listitem>
<para
>Un estri que proporciona una llista en la forma d'una estructura en arbre. Aquest estri ara està totalment activat per afegir o treure elements a partir d'alfa 6. Podeu afegir elements fill i dades de múltiples columnes. La limitació actual és que no es poden modificar les columnes. Per afegir un node fill utilitzeu <quote
>/</quote
> com a separador. Per afegir dades a la columna utilitzeu el caràcter de tabulació <quote
>\t</quote
> entre les columnes. </para>
</listitem>
</varlistentry>
</variablelist>
</sect1>