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
Ver también
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 .add.
  • La función .Insert 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"
LIST_CustomerList.Insert("Clark", 4)
WINDEVCódigo de Usuario (UMC)
// Add the "C:\MyImages\CoralReef.JPG" image in 5th position to "LSV_Diving"
// The caption of this image will be "Nice coral"
LSV_Diving.Insert("Coral Reef", "C:\MyImages\CoralReef.JPG", 4)
Sintaxis
<Result> = <List Box control>.Insert(<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.
<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).
WINDEVJava Para un control ListView, este parámetro corresponde a la leyenda Image. Este parámetro puede contener caracteres de retorno de carro (CR) para añadir varios elementos. En este caso:
  • si <Imagen> y <Índice del elemento> no se especifican, los elementos añadidos se asociarán a la imagen por defecto (definida en la pestaña "Detalles" de la ventana de control description).
  • si se especifican los parámetros <Imagen> e <Índice del elemento>, solo se agregará el primer elemento. Este elemento se asociará a la imagen por defecto (definida en la pestaña "Detalles" de la ventana description de control).
  • si <Image> es especificado y si <Indice de elemento> no es especificado, sólo se añadirá el primer elemento. Este elemento será associated con el Image especificado.
Java Los caracteres de retorno de carro (CR) y las tabulaciones (TAB) no son compatibles.
<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).
Universal Windows 10 App Este parámetro no está disponible.
<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 <List Caja>.Cuenta.
  • 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.
WINDEVJavaCódigo de Usuario (UMC)

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.
WINDEVCódigo de Usuario (UMC)

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.
WINDEVUniversal Windows 10 AppJavaCódigo de Usuario (UMC)

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 .add en lugar de .Insert para añadir un elemento a un control List Box ordenado.
WINDEVCódigo de Usuario (UMC)

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:
LIST_Customer.Insert(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 .Insert 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 .Insert, se aconseja definir el ancho de las columnas con <Tipo ANSI string>.Complete. Por ejemplo, para fijar el ancho de las columnas que se encuentran en "LIST_Customer" a 10 caracteres:
LIST_Customer.Insert(Complete(LastName, 10) + TAB + Complete(FirstName, 10))

Varios

  • Para insertar un elemento en una control Tabla, utilice
.Insert.
  • .Insert puede utilizarse en una columna "Combo Box" en un control Tabla.
  • Componente: wd290obj.dll
    .Insert (Función)
  • Funciones para el manejo de los controles List Box, ListView y Combo Box (sintaxis de prefijo)
  • ListInsert (Función)
  • gStoredValue( Función)
  • Versión mínima requerida
    • Versión 23
    Esta página también está disponible para…
    Comentarios
    Haga clic en [Agregar] para publicar un comentario

    Última modificación: 20/06/2023

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