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

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

<othercredit role="translator"
><firstname
>Juan Manuel</firstname
> <surname
>García Molina</surname
> <affiliation
><address
><email
>juanma@superiodico.net</email
></address
></affiliation
><contrib
>Traductor</contrib
></othercredit
> 

</authorgroup>
</sect1info>

<title
>Widgets</title>

<para
>Los bloques de construcción de un cuadro de diálogo de &kommander; son los widgets. Son como cualquier otro widget de las bibliotecas de &Qt; y de &kde;, salvo que poseen alguna funcionalidad extra que les permite tener una <quote
>asociación de texto</quote
>. El texto se asocia con el estado del widget o su slot populate. El número de estados depende del widget. Si un widget sólo tiene un estado, a este estado se le llama predefinido. </para>

<para
>Texto del widget bla bla</para>

<para
>El cuadro de diálogo tiene dos estados especiales para el texto de &kommander;. Son Initiate (iniciar) y Destroy (destruir), y se ejecutan cuando se inicializa y destruye el cuadro de diálogo. Protegen contra las llamadas <quote
>condiciones de carrera</quote
> en la apertura y eliminan la necesidad de procedimientos especiales al cierre.</para>


<variablelist>
<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="buttongroup.png" format="PNG"/>
</imageobject
></inlinemediaobject
> ButtonGroup </term>
<listitem>
<para
>Un contenedor para organizar botones en grupo. Se puede establecer un título opcional con la propiedad title (título). El marco se puede ajustar con la propiedad lineWidth (ancho de línea). El grupo de botones se puede definir como exclusivo estableciendo la propiedad exclusive (exclusivo) a «verdadero», con lo que, cuando se haga clic sobre un botón, los demás se desactivarán, excepto en los botones de radio, que siempre son mutuamente exclusivos aunque el grupo no lo sea. Los botones de radio se pueden definir como no exclusivos usando la propiedad radioButtonExclusive (botón de radio exclusivo) (No es seguro que esta propiedad funcione realmente). </para>
<para
>Un ButtonGroup tiene un estado, el predefinido.</para>
<para
>El texto del widget para un ButtonGroup son las asociaciones de texto para cada uno de los botones, en el orden en que aparecen en el grupo. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="checkbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> CheckBox </term>
<listitem>
<para
>Un botón que puede estar marcado o sin marcar. También puede estar semimarcado si la propiedad tristate (triestado) está definida a «verdadero». La etiqueta asociada con el CheckBox se define en la propiedad text (texto). Estableciendo la propiedad checked (marcado), la casilla se marcará al inicio. </para>
<para
>Un CheckBox (casilla de verificación) tiene 3 estados, marcado, semimarcado y sin marcar. </para>
<para
>El texto del widget para un Checkbox es el valor de la propiedad text (texto). </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="pushbutton.png" format="PNG"/>
</imageobject
></inlinemediaobject
> CloseButton </term>
<listitem>
<para
>Un botón que, cuando se hace clic sobre él, ejecuta su asociación de texto y luego cierra el cuadro de diálogo. La etiqueta del botón se define con la propiedad text (texto). La salida de la asociación de texto (cómo decirlo) se mostrará en la salida estándar siempre que la propiedad writeStdout (n.t. escribir a salida estándar) esté definida a «verdadero». </para>
<para
>Un CloseButton tiene un estado, el predefinido. </para>
<para
>No han ningún texto de widget asociado con CloseButton. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="combobox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> ComboBox </term>
<listitem>
<para
>Un ComboBox (lista de selección) es un widget de selección que combina un botón y un menú desplegable. Muestra la opción actual del usuario en una lista de opciones en un espacio mínimo. Los elementos se añaden a la lista usando la ventana de edición. Si está definida la propiedad editable a «verdadero», el usuario puede introducir cadenas arbitrarias. </para>
<para
>Un ComboBox tiene un estado, el predefinido. </para>
<para
>El texto del widget de un ComboBox es el texto del elemento seleccionado. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="pushbutton.png" format="PNG"/>
</imageobject
></inlinemediaobject
> ExecButton </term>
<listitem>
<para
>Un botón que, cuando se pulsa, ejecuta su asociación de texto. La etiqueta del botón se define con la propiedad text (texto). La salida de la asociación de texto (cómo decirlo) se mostrará en la salida estándar siempre que la propiedad writeStdout (n.t. escribir a salida estándar) esté definida a como «verdadero». </para>
<para
>Un ExecButton tiene un estado, el predefinido. </para>
<para
>No hay ningún texto de widget asociado con ExecButton. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="lineedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> FileChooser </term>
<listitem>
<para
>El widget FileChooser (selector de archivos) combina un LineEdit (editor de línea) con un botón que, al pulsarse, muestra un cuadro de selección de archivos o carpetas. El archivo o carpeta seleccionado se almacena en el LineEdit. El tipo de FileChooser se define con la propiedad selectionType (tipo de selección). Los tipos disponibles son Open (abrir), Save (guardar) y Directory (directorio). Se pueden seleccionar varios archivos o carpetas si la propiedad selectionOpenMultiple (selección de apertura múltiple) está definida a «verdadero». Se puede definir un título para el FileChooser con la propiedad selectionCaption (n.t. título de selección), que se mostrará como título del cuadro de diálogo. Si no se indica título, se mostrará el tipo de selección. Los archivos mostrados se pueden limitar mediante la propiedad selectionFilter (filtro de selección). </para>
<para
>Un FileChooser tiene un estado, el predefinido. </para>
<para
>El texto del widget para un FileChooser es el texto del LineEdit (el archivo seleccionado por el usuario). </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="groupbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> GroupBox </term>
<listitem>
<para
>Un widget contenedor que alberga otros widgets. El marco se ajusta con la propiedad lineWidth (ancho de línea). Se puede añadir un título definiendo la propiedad title (título). </para>
<para
>Un GroupBox tiene un estado, el predefinido. </para>
<para
>El texto del widget GroupBox (caja de grupo) es la combinación del texto de cada uno de los widgets de texto que contiene, en el orden en que aparecen dentro del GroupBox. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="lineedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> LineEdit </term>
<listitem>
<para
>Un widget LineEdit (editor de línea) es un editor de textos de una línea, que permite que el usuario introduzca una y la modifique. El texto inicial del editor se puede definir en la propiedad text (texto). El widget se puede definir como de sólo lectura con la propiedad readOnly (sólo lectura). Hay 3 modos para el widget: Normal, NoEcho (sin eco) y Password (contraseña), que se definen con la propiedad echoMode (modo de eco). </para>
<para
>Un LineEdit tiene un estado, predefinido. </para>
<para
>El texto del widget LineEdit es el texto que contiene el editor. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="listbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> ListBox </term>
<listitem>
<para
>Un widget ListBox (lista de selección múltiple) proporciona una lista de elementos seleccionables. Normalmente, hay uno o ninguno seleccionado. Este comportamiento se puede modificar con la propiedad selectionMode (modo de selección). Los elementos se añaden al ListBox usando la ventana de edición. </para>
<para
>Un ListBox tiene sólo un estado, el predefinido. </para>
<para
>El texto del widget ListBox son los elementos que contiene. @selectedWidgetText sólo devolverá los elementos que estén seleccionados en ese momento. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="listview.png" format="PNG"/>
</imageobject
></inlinemediaobject
> ListView </term>
<listitem>
<para
>Este widget ahora está activado en &kommander;. Su funcionamiento es el mismo que en el widget de árbol, así que puede consultar la referencia completa de este. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="pixlabel.png" format="PNG"/>
</imageobject
></inlinemediaobject
> PixmapLabel </term>
<listitem>
<para
>Un widget sencillo que contiene una imagen o una etiqueta de texto. El pixmap a mostrar se define en la propiedad pixmap, y el texto en la propiedad text (texto). Sólo se puede definir una de las dos propiedades (eso creo, porque no puedo hacer que el editor defina ambas simultáneamente). Si scaledContents (contenido escalado) está definido como «verdadero», la imagen se escalará hasta ajustarse al tamaño del widget. El formato del texto se puede definir con la propiedad textFormat (formato de texto). </para>
<para
>Este widget no está activado en &kommander; y no tiene ningún estado o texto de widget. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="radiobutton.png" format="PNG"/>
</imageobject
></inlinemediaobject
> RadioButton </term>
<listitem>
<para
>Un botón que se puede marcar o desmarcar, utilizado habitualmente en el ButtonGroup (grupo de botones) para hacer un selección exclusiva. La etiqueta asociada con el botón se puede definir en la propiedad text (texto). Se puede inicializar un botón como marcado si se define la propiedad checked (marcado) como «verdadero». Si todos los RadioButtons de un ButtonGroup tienen la propiedad checked (marcado) así definida, el único que quedará marcado será el último. </para>
<para
>Un RadioButton tiene 2 estados, marcado y sin marcar. </para>
<para
>No hay ningún texto de widget asociado con un RadioButton. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="richtextedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> RichTextEditor </term>
<listitem>
<para
>Este widget proporciona un editor de texto que permite un formateo simple. </para>
<para
>Un RichTextEditor tiene un estado, el predefinido. </para>
<para
>El texto de widget para RichTextEditor es el texto que contiene el editor, en formato de texto rico. El texto seleccionado se puede devolver con @selectedWidgetText. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="spinbox.png" format="PNG"/>
</imageobject
></inlinemediaobject
> SpinBoxInt </term>
<listitem>
<para
>Un widget que permite al usuario cambiar un valor entero presionando las flechas arriba y abajo o introduciendo un valor en la casilla. Los valores mínimo y máximo del widget se pueden definir con las propiedades minValue(valor mín.) y maxValue (valor máx.). La propiedad specialValueText (texto de valor especial) se usa para definir el valor que se mostrará en lugar del valor mínimo. </para>
<para
>Este widget sólo tiene un estado, el predefinido. </para>
<para
>El texto del widget SpinBoxInt es el valor entero que se muestra en el momento. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="frame.png" format="PNG"/>
</imageobject
></inlinemediaobject
> SubDialog </term>
<listitem>
<para
>Un botón que, al presionarse, lanza otro cuadro de diálogo de &kommander;. Dicho cuadro de diálogo se define en la propiedad kmdrFile (archivo kmdr). Si la propiedad default (predefinida) está establecida a «verdadero», el nuevo cuadro de diálogo se ejecutará si se pulsa Intro cuando el actual tenga el foco. Creemos que también se puede usar como contenedor, aunque es necesario probarlo un poco más. </para>
<para
>Un SubDialog tiene un estado, el predefinido. </para>
<para
>El texto de widget de SubDialog (sub-cuadro de diálogo) es la asociación de texto del cuadro de diálogo que ejecuta. </para>
<note
><para
>Esto es algo parecido a contener el cuadro de diálogo, que se ha quedado obsoleto con el nuevo concepto de proyecto. ¿Deberíamos dejarlo con <function
>@dialog()</function
> en el texto de &kommander; u olvidarnos de ello? No está bien tal y como está.</para
></note>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="tabwidget.png" format="PNG"/>
</imageobject
></inlinemediaobject
> TabWidget </term>
<listitem>
<para
>Un widget que proporciona varias solapas que a su vez pueden contener otros widgets. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="multilineedit.png" format="PNG"/>
</imageobject
></inlinemediaobject
> TextEdit </term>
<listitem>
<para
>Un editor de texto simple con varias líneas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="label.png" format="PNG"/>
</imageobject
></inlinemediaobject
> TextLabel </term>
<listitem>
<para
>Un widget sencillo que contiene un trozo de texto. Este widget le permite también definir un pixmap. De acuerdo, el editor dice que ambos son QLabels. Entonces, ¿por qué tenemos 2 widgets que parecen lo mismo pero con dos nombres diferentes? Está planificado para que se corrija en la A7. </para>
<para
>En la alfa 6, este widget está parcialmente activado, y se puede definir usando llamadas DCOP externas. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<inlinemediaobject
><imageobject>
<imagedata fileref="listview.png" format="PNG"/>
</imageobject
></inlinemediaobject
> TreeWidget </term>
<listitem>
<para
>Un widget que proporciona una lista con forma y estructura de árbol. Este widget no está activado completamente para añadir o eliminar elementos en la alfa 6. Puede añadir elementos hijo y datos de varias columnas. La limitación actual es que no puede modificar las columnas. Para añadir un nodo hijo, use <quote
>/</quote
> como separador. Para añadir los datos de la columna, use el carácter de tabulador con escape <quote
>\t</quote
> entre las columnas. </para>
</listitem>
</varlistentry>
</variablelist>
</sect1>
