AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Controles, páginas y ventanas / Funciones List Box
  • Lista control con más de 10.000 elementos
  • Visibilidad/Invisibilidad de los elementos en un List Box o control Combo Box
  • Personalizar los elementos que se encuentran en un List Box o control Combo Box
  • control List Box clasificada/sin clasificar
  • Tabulaciones: Multiselección control List Box
  • Varios
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
Inserta un elemento en una Caja de Listas, ListView o control Combo Box poblada programáticamente.
Observaciones:
  • Para añadir un elemento al final del cuadro de lista (o Combo Box) control, utilice ListAdd.
  • La función ListInsert puede utilizarse en controles List Box de selección única y múltiple
  • Para gestionar el contenido de una control Combo Box en una columna contenedora de una control Tabla, utilice el Contenido Property.
Ejemplo
// Add "Clark" in 4th position to "LIST_CustomerList"
ListInsert(LIST_CustomerList, "Clark", 4)
Reportes y Consultas
// Add the "C:\MyImages\CoralReef.JPG" image in 5th position to "LSV_Diving"
// The caption of this image will be "Nice coral"
ListInsert(LSV_Diving, "Nice coral", "C:\MyImages\CoralReef.JPG", 4)
Sintaxis
<Result> = ListInsert(<List Box control> , <Element> [, <Image> [, <Element index>]])
<Result>: booleano
  • True si se insertó el elemento,
  • False en caso contrario.
<List Box control>: Nombre del control
Nombre de la caja de lista o control Combo Box rellenada programáticamente.
Si este parámetro corresponde a una cadena vacía (""), el elemento se inserta en el List Box o control Combo Box al que pertenece el Process actual.
<Element>: Cadena de caracteres
Elemento que debe ser insertado en el Cuadro de Listas especificado (o Combo Box) control poblado programáticamente.
Este parámetro puede contener:
  • Caracteres de retorno de carro (CR) para añadir varias filas. En este caso:
    • si no se especifica <índice del elemento>, se añaden los elementos.
    • Si se especifica <Indice del elemento>, sólo se añadirá el primer elemento.
  • (TAB) para obtener una control List Box multi-elemento (ver Notas).
<Image>: Cadena de caracteres opcional
Nombre y ruta de la imagen que se añadirá a un control ListView. Este parámetro se tiene en cuenta sólo para los controles ListView visualizados en modo ListView.. Si no se especifica este parámetro, se utilizará la imagen por defecto (definida en la pestaña "Detalles" de la ventana description de control).
<Element index>: Entero opcional
Índice del elemento a insertar.
Si este parámetro:
  • no se especifica, se inserta el elemento:
    • antes de la etapa de corriente en una control List Box de selección simple. Si no hay ningún elemento actual, el elemento se inserta en la última posición de la Caja de Listas (o Combo Box) control poblada programáticamente.
    • en la última posición de la Caja de Listas (o Combo Box) control poblada programáticamente, en una multiselección control List Box.
  • es mayor que el número de elementos de la Caja de Lectura (o Combo Box) control, el elemento se inserta en la última posición de la Caja de Lectura (o Combo Box) control poblada programáticamente. El número de elementos de un control de cuadro de lista (o Combo Box) es devuelto por ListCount.
  • es igual a 0, el elemento se añade en la primera posición de la Caja de Listas (o Combo Box) control poblada programáticamente.
Observaciones

Lista control con más de 10.000 elementos

El número máximo de elementos de una control List Box sólo está limitado por la memoria disponible (máximo teórico: 2 mil millones de filas). Sin embargo, poblar una control List Box con un gran número de elementos (más de 10.000) afecta al rendimiento.
Para añadir un gran número de elementos, se recomienda utilizar una control List Box basada en un archivo de datos HFSQL.
Reportes y Consultas

Visibilidad/Invisibilidad de los elementos en un List Box o control Combo Box

Para que un elemento sea Invisible en un cuadro de lista o control Combo Box, utilice gStoredValue.
Reportes y Consultas

Personalizar los elementos que se encuentran en un List Box o control Combo Box

Para personalizar los elementos de un cuadro de lista o control Combo Box (fondo Color, imagen, dibujo, etc.), utilice Funciones de gestión de cadenas gráficas.
Reportes y Consultas

control List Box clasificada/sin clasificar

  • Si se ordena la control List Box, el nuevo elemento se inserta en la posición actual sin ordenar el list box.
  • Si la control List Box no está clasificada, se añade el nuevo elemento:
    • en <índice del elemento> si se especifica <índice del elemento>.
    • antes del elemento actual en una control List Box de selección única si no se especifica el parámetro <Indice del elemento>.. Si no hay ningún elemento actual, el elemento se inserta en la última posición de la Caja de Listas (o Combo Box) control poblada programáticamente.
    • en la última posición del cuadro de lista (o Combo Box) control poblado programáticamente en una multiselección control List Box, si no se especifica el <índice de elemento>.
El tipo de la control List Box (clasificada o no) se selecciona durante el control description (pestaña "Detalles").
Utilice ListAdd en lugar de ListInsert para añadir un elemento a un control List Box ordenado.
Reportes y Consultas

Tabulaciones: Multiselección control List Box

Para gestionar las tabulaciones en una control List Box (alineación de columnas), utilice la constante TAB. Por ejemplo:
ListInsert(LIST_Customer, LastName + TAB + FirstName)
En este ejemplo, todos los nombres comienzan en la misma posición y están alineados uno debajo del otro.
Observación: La posición de las tabulaciones se define al llamar a la función ListInsert por primera vez. Estas posiciones se tomarán como reference para todos los valores añadidos a partir de entonces. Del mismo modo, si se han tecleado valores introducidos en el editor, las posiciones de estos valores se toman como reference. Durante la primera llamada a ListInsert, se aconseja definir el ancho de las columnas con Complete. Por ejemplo, para fijar el ancho de las columnas que se encuentran en "LIST_Customer" a 10 caracteres:
ListInsert(LIST_Customer, Complete(LastName, 10) + TAB + Complete(FirstName, 10))

Varios

  • Para insertar un elemento en una control Tabla, utilice TableInsert.
  • ListInsert puede utilizarse en una columna "Combo Box" en un control Tabla.
Componente: wd290obj.dll
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Exemplo ListInsert
ListInsert(LIST_List,"Primeiro",1)
ListInsert(LIST_List,"Segundo",2)

ListInsert(LSV_Listview, "Imagen 1","D:\_GRAVACOES\Amarildo\Blog_Mandar_imagem\2016-10-04_1348.png", 1)
ListInsert(LSV_Listview, "Imagen 2","D:\_GRAVACOES\Amarildo\07112016_segunda\001\Video_Falta_1000.png", 2)

//Blog com Video E Exemplo
http://windevdesenvolvimento.blogspot.com.br/2016/11/aula-962-curso-windev-listbox-007.html
https://www.youtube.com/watch?v=M1jF2-ouHiw


De matos
04 12 2016

Última modificación: 08/06/2022

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