AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Ayuda / Desarrollar una aplicación o un sitio web / Controles, ventanas y páginas / Controles: tipos disponibles / Control List Box
  • Presentación
  • Inicializar un control Combo Box
  • Inicializar un elemento
  • Rellenar un control List Box
  • Seleccionar un elemento en un control List Box
  • Seleccionar una fila
  • Fijar la posición en el último elemento
  • Obtener el elemento seleccionado en un control List Box
  • Obtener el índice del elemento seleccionado
  • Obtener el valor del elemento seleccionado
  • Recorrer los elementos de un control List Box
  • Propiedades específicas de los controles List Box
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Presentación
WINDEV, WEBDEV y WINDEV Mobile permiten manipular controles List Box mediante programación. Para ello, utilice la variable del control List Box en el código. Esta variable es de tipo numérico.
La variable del control List Box:
  • corresponde al nombre del control List Box.
  • se inicializa con el índice del elemento seleccionado en el control.
Para manipular un elemento del control List Box, utilice la siguiente notación:
<List Box control> [<Element index>]
Observación: Existen varias funciones WLanguage específicas para los controles List Box. Para obtener más información, consulte funciones de gestión de controles List Box.
Inicializar un control Combo Box

Inicializar un elemento

Para inicializar un elemento en un control List Box, utilice la función ListAdd.
Observación: Para modificar un elemento en un control List Box, utilice la siguiente sintaxis:
<List Box control>[Index] = <Value>
Por ejemplo:
// Add elements
ListAdd(LIST_LIST1, "MOORE")
ListAdd(LIST_LIST1, Cust_Name)
// Modify elements
LIST_LIST1[3] = "MOORE"

Rellenar un control List Box

Para inicializar un control Combo Box, simplemente utilice un bucle de iteración para inicializar todos los elementos del control.
Index is int
FOR Index = <Start position> TO <End position>
ListAdd(<List Box control>, <Value>)
END
Ejemplo:
i is int
FOR i = 1 TO 52
ListAdd(LIST_LIST1, NAME[i])
END
Seleccionar un elemento en un control List Box

Seleccionar una fila

Para seleccionar un elemento en la fila <Index> utilice:
  • la asignación directa:
    <List Box control> = Index
  • la función ListSelectPlus:
    ListSelectPlus(<List Box control>, <Index>)

Fijar la posición en el último elemento

Para fijar la posición en el último elemento del control List Box, utilice:
  • la propiedad Count:
    <List Box control>.Count
  • la función ListSelectPlus con la propiedad Count:
    ListSelectPlus(<List Box control>, <List Box control>.Count)
  • la función ListCount:
    ListCount(<List Box control>)
Obtener el elemento seleccionado en un control List Box

Obtener el índice del elemento seleccionado

Para obtener el índice del elemento seleccionado, utilice una de las siguientes sintaxis:
  • leer directamente el elemento:
    Index = <List Box control>
  • la función ListSelect:
    Index = ListSelect(<List Box control>)
Observación: En los controles List Box de selección múltiple, la función ListSelect permite obtener los elementos seleccionados.
// Retrieve the elements of a multi-selection List Box control
Rank is int = 0  // selection number
Index is int = 0  // index of the selected element
LOOP
Rank = Rank + 1
Index = ListSelect(LIST_LIST1, Rank)
IF Index = - 1 THEN BREAK
END

Obtener el valor del elemento seleccionado

Para obtener el valor del elemento seleccionado, utilice una de las siguientes sintaxis:
  • Sintaxis 1:
    Index is int = <List Box control>
    <Variable> = <List Box control>[Index]
  • Sintaxis 2:
    <Variable> = <List Box control>[<List Box control>]
  • Sintaxis 3: Propiedad DisplayedValue (en código Servidor únicamente)
    Variable> = <List Box control>[Index].DisplayedValue
Atención: El valor almacenado puede ser diferente del valor que muestra. Para obtener el valor almacenado correspondiente a una de las filas del control List Box, utilice la propiedad StoredValue.
Recorrer los elementos de un control List Box
La instrucción FOR EACH realiza diferentes tipos de iteraciones en los controles List Box:
  • Recorrer los elementos del control. Se utiliza la siguiente sintaxis:
    FOR EACH ROW [<Index> [, <Counter>]] OF <List Box control>
     ...
    END
    donde:
    • <Index>: Variable opcional de tipo Integer. Por cada iteración, contiene el índice de la fila actual.
    • <Counter>: Variable opcional de tipo Integer. Esta variable cuenta el número de iteraciones.
  • Recorrer los elementos seleccionados. Se utiliza la siguiente sintaxis:
    FOR EACH SELECTED ROW [<Index>, [<Counter>]] OF <List Box control>
       ...
    END
    donde:
    • <Index>: Variable de tipo Integer. Por cada iteración, contiene el índice de la fila actual seleccionada.
    • <Counter>: Variable opcional de tipo Integer. Esta variable cuenta el número de iteraciones (número de filas seleccionadas, por ejemplo).
Para obtener más información, consulte Instrucción FOR EACH/FOR ALL (recorrer controles).
Propiedades específicas de los controles List Box
Las siguientes propiedades son específicas de los controles List Box:
Todos los tipos de controles List Box
HorizontalAlignmentObtiene y establece la alineación horizontal de los elementos en el control List Box.
LineHeightObtiene y establece la altura de las filas en un control List Box.
MemoryIndica si el control List Box especificado se rellena mediante programación o si está basado en un archivo de datos.
CountObtiene el número de filas de un control List Box.
FillTypeIndica cómo se rellena un control (mediante programación, desde un archivo de datos o desde una variable). Se aplica a los controles Tabla, List Box, ListView, Combo Box y Looper.
DisplayedValueObtiene el valor de la fila actual o el valor de una fila específica en el control List Box.
StoredValueObtiene el valor almacenado actualmente al seleccionar una fila en el control List Box.
EmptyIndica si un control List Box está vacío.
Control List Box rellenado mediante programación únicamente
InitialContentObtiene el contenido inicial de un control List Box rellenado mediante programación.
SortedIndica si un control List Box rellenado mediante programación está ordenado, u ordena el control.
Control List Box basado en un archivo de datos únicamente
BrowsedFileObtiene o establece el archivo de datos o consulta utilizado para mostrar registros en los controles Combo Box.
AutoBrowseIndica si un control List Box se recorre de forma automática o mediante programación.
DisplayedItemObtiene y establece el campo que se muestra en un control List Box.
StoredItemObtiene y establece el campo almacenado de un control List Box.
BrowsedItemObtiene y establece el campo utilizado para recorrer automáticamente los controles List Box.

Para obtener la lista completa de las propiedades WLanguage que pueden utilizarse con un control List Box, consulte Propiedades asociadas a los controles List Box.
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 24/02/2023

Señalar un error o enviar una sugerencia | Ayuda local