# VBoundFieldListBox





**Hereda de:** [Widget](widget).

Esta clase representa al control listBox de campo enlazado.

## [Propiedades](#documentación-de-propiedades)

Number [batchSize](#batchsize)

const Number [count](#count)

Number [currentRow](#currentrow)

Number [flow](#flow)

Boolean [isWrapping](#iswrapping)

Number [layoutMode](#layoutmode)

Number [movement](#movement)

Number [resizeMode](#resizemode)

Number [selectionMode](#selectionmode)

Boolean [selectionRectVisible](#selectionrectvisible)

Number [spacing](#spacing)

Boolean [uniformItemSizes](#uniformitemsizes)

Number [viewMode](#viewmode)

Boolean [wordWrap](#wordwrap)

## Indice de funciones

### **Generales**

void [clearSelection](#clearselection)()

void [scrollToBottom](#scrolltobottom)()

void [scrollToTop](#scrolltotop)()

void [selectAll](#selectall)()

## Señales

Item: cambio de seleccionado

## Enumeraciones

**Flow**

* LeftToRight
* TopToBottom

**Layout mode**

* SinglePass
* Batched

**Movement**

* Static
* Free
* Snap

**Resize mode**

* Fixed
* Adjust

**Selection mode**

* SingleSelection
* ContiguousSelection
* ExtendedSelection
* MultiSelection
* NoSelection

**View mode**

* ListMode
* IconMode

## Documentación de propiedades

#### batchSize

Permite leer o especificar el número de elementos que se gestionarán en cada lote si el layoutMode se establece el lotes. El valor por defecto es 100.

#### count

Devuelve el número de elementos del control.

#### currentRow

Permite leer o configurar la fila seleccionada o en curso.

#### flow

Permite leer o configurar la dirección en la que deben fluir los elementos deben fluir. Ver enum Flow. Si esta propiedad es LeftToRight, los artículos serán dispuestos de izquierda a derecha. Si la propiedad isWrapping es true, el diseño se ajustará cuando se alcanza el lado derecho de la zona visible. Si esta propiedad es TopToBottom, los elementos quedan dispuestos desde la parte superior de la zona visible, envolviendo cuando alcanza la parte inferior. Modificar esta propiedad cuando la vista es visible hará que los elementos se establezcan de nuevo. De forma predeterminada, esta propiedad se establece en TopToBottom.

#### isWrapping

Permite leer o configurar si los elementos se comportarán de forma circular. Modificar esta propiedad cuando la vista es visible hará que los elementos se establezcan de nuevo. De forma predeterminada, esta propiedad es false.

#### layoutMode

Permite leer o configurar si la carga de los elementos debe ocurrir inmediatamente o se debe demorar. Ver enum Layout mode. Cuando el modo es SinglePass (por defecto), los elementos se cargan todos de una vez. Cuando el modo se dosifica, los elementos se disponen en lotes de elementos BatchSize, durante el procesamiento de eventos. Esto hace que sea posible ver al instante e interactuar con los elementos visibles, mientras que el resto está siendo cargados.

#### movement

Permite leer o configurar si los elementos se pueden mover libremente, se ajustan a una red, o no se pueden mover en absoluto. Ver enum Movement. Esta propiedad determina cómo el usuario puede mover los elementos en la vista. Estático significa que los artículos no pueden ser trasladados al usuario. Libre significa que el usuario puede arrastrar y soltar los elementos a cualquier posición en la vista. Snap significa que el usuario puede arrastrar y soltar los elementos, pero sólo para las posiciones en una red teórica representada por la propiedad gridSize. Al establecer esta propiedad cuando la vista es visible hará que los elementos que se establezcan de nuevo. De forma predeterminada, esta propiedad se establece como Estática.

#### resizeMode

Permite leer o configurar si los elementos se colocan de nuevo cuando la vista cambia de tamaño. Ver enum Resize mode. Si se modifica la propiedad al valor Adjust, los elementos se colocarán de nuevo cuando la vista cambia de tamaño. Si el valor es Fixed, los elementos no cambiarán si el control cambia de tamaño. De forma predeterminada, esta propiedad se establece en Fixed.

#### selectionMode

Permite leer o configurar el modo de selección de elementos en el control. Ver enum Selection mode.

#### selectionRectVisible

Permite leer o configurar si el rectángulo de selección debe ser visible. Si esta propiedad es true, el rectángulo de selección es visible, de lo contrario estará oculto.

Nota: el rectángulo de selección sólo será visible si el modo de selección está en un modo donde puede haber más de un elemento seleccionado, es decir, no se dibuja un rectángulo de selección si el modo de selección es SingleSelection. De forma predeterminada, esta propiedad es false.

#### spacing

Permite leer o configurar el espacio alrededor de los elementos en el control. El tamaño del espacio vacío que se rellena en torno a un elemento. Al establecer esta propiedad cuando el control es visible hará que los elementos que se pinten de nuevo. De forma predeterminada, esta propiedad contiene un valor de 0.

#### uniformItemSizes

Permite leer o configurar si todos los elementos del control tienen el mismo tamaño. Esta propiedad sólo debe establecerse a true si se garantiza que todos los elementos de la vista tienen el mismo tamaño. Esto permite al control optimizarse para mejorar el rendimiento. De forma predeterminada, esta propiedad es false.

#### viewMode

Permite leer o configurar el modo de vista, similar a un ListView. Ver enum View mode.

#### wordWrap

Permite leer o configurar si el texto contenido en los elementos se ajustará por palabra. Si esta propiedad es true, el texto del elemento se ajusta, de lo contrario no se ajusta en absoluto. Esta propiedad es false de forma predeterminada. Tenga en cuenta que incluso si el ajuste está activado, la celda no se ampliará para dar cabida al texto. Se imprimirán puntos suspensivos para el texto que no se puede mostrar, de acuerdo con textElideMode de la vista.

## Documentación de funciones

### Funciones generales

#### void clearSelection() <a href="#clearselection" id="clearselection"></a>

Dejar la lista sin ningún registro seleccionado.

#### void scrollToBottom() <a href="#scrolltobottom" id="scrolltobottom"></a>

Mover la lista un registro hacia abajo. Equivale a hacer clic en el botón flecha abajo de la barra de desplazamiento.

#### void scrollToTop() <a href="#scrolltotop" id="scrolltotop"></a>

Mover la lista un registro hacia arriba. Equivale a hacer clic en el botón flecha arriba de la barra de desplazamiento.

#### void selectAll() <a href="#selectall" id="selectall"></a>

Seleccionar todos los registros de la lista.

## Ejemplo

### Forzar la selección del primer ítem de un listbox que edita un campo enlazado a maestro si no hay seleccionado ninguno

```
// Capturamos el formulario y el control listbox
form = theRoot.dataView();
var controlEdicion = form.control("MAESTROS_NAME");
//Si no tiene seleccionado ningún item, forzamos la selección del primero
if ( controlEdicion.currentRow == -1)
{
	controlEdicion.currentRow=0;
}
```
