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
  • List Boxes que contienen más de 10 000 elementos
  • Visibilidad/Invisibilidad de los elementos en un List Box o control Combo Box
  • Equivalencia
  • control List Box clasificada/sin clasificar
  • Personalizar los elementos que se encuentran en un List Box o control Combo Box
  • Tabulaciones: Multi-elemento control List Box
  • Varios
Añade un elemento a:
  • a control List Box poblada programáticamente,
  • WINDEVJava a control ListView poblada programáticamente,
  • WINDEV y control Carrusel,
  • a control Combo Box poblada programáticamente.
Observaciones:
  • Para añadir un elemento en una posición concreta, utilice .Insert.
  • La función .add puede utilizarse en los controles List Box de selección única y selección múltiple.
  • Para añadir una Image a una control List Box estándar, utilice gImage.
  • Para añadir elementos a una control Combo Box que se encuentra en una columna contenedora de una control Tabla, utilice Contenido.
Ejemplo
// Add the customer named "Moore" into "LIST_CustomerList"
LIST_CustomerList.Add("Moore")
WINDEVUniversal Windows 10 AppJavaCódigo de Usuario (UMC)
// Add the customers named "Clark" and "Smith" into "LIST_CustomerList"
LIST_CustomerList.Add("Clark" + CR + "Smith")
WINDEVJavaCódigo de Usuario (UMC)
// Add the "C:\MyImages\CoralReef.JPG" image into the "LSV_Diving" listview control
// The caption of this image will be "Nice coral"
LSV_Diving.Add("Nice coral", "C:\MyImages\CoralReef.JPG")
WINDEVUniversal Windows 10 AppJavaCódigo de Usuario (UMC)
// The "COMBO_Title" Combo Box displays personal titles:
// "Mister", "Madam" and "Miss".
// An integer representing a gender will be returned to the language.
COMBO_Title.Add("Mister" + gStoredValue("1"))
Sintaxis
<Result> = <Control to use>.Add([<Element> [, <Path of image to display>]])
<Result>: booleano
  • True si se agregó el elemento,
  • False en caso contrario.
<Control to use>: Nombre del control
Nombre del control a manipular.
<Element>: Cadena de caracteres opcional
Elemento que se añadirá en la control especificada. Si no se especifica este parámetro, se añade un fila vacío en el List Box o control Combo Box.
Este parámetro puede contener:
  • Caracteres de retorno de carro (CR) para añadir varios elementos.
  • (TAB) para obtener una control List Box multi-elemento (ver Notas).
  • gStoredValue para indicar el valor que se devolverá cuando se seleccione el elemento.
WINDEV Para un control Carrusel, el contenido de este parámetro se muestra al pasar el cursor sobre el elemento en la esquina superior izquierda del control Carrusel.
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 ese caso:
  • si no se especifica <Ruta de la imagen a mostrar>, los elementos añadidos se asociarán a la imagen por defecto (definida en la pestaña "Detalles" de la ventana description de control).
  • si se especifica <Ruta de Image a mostrar>, sólo se añadirá el primer elemento. Este elemento será associated con el Image especificado.
Java Se admiten los caracteres de retorno de carro (CR), mientras que no se admiten las tabulaciones (TAB).
<Path of image to display>: Cadena de caracteres opcional
Nombre y ruta de la imagen que se añadirá a un control ListView. También tiene la posibilidad de utilizar una partida de notas de Image.
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.
Observaciones

List Boxes que contienen 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, llenar un control List Box con un número importante de elementos (más de 10 000) afecta al rendimiento
Para añadir muchos elementos a un control List Box, se recomienda utilizar un control List Box basado en un archivo de datos (es decir, una lista directamente relacionado a 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.
WINDEVUniversal Windows 10 AppJavaCódigo de Usuario (UMC)

Equivalencia

Las dos sintaxis siguientes son equivalentes:
<Control name>.Add([<Element>])
y
<Control name>[Index] = <Element>
WINDEVUniversal Windows 10 AppJavaCódigo de Usuario (UMC)

control List Box clasificada/sin clasificar

  • Si se clasifica el control List Box, el nuevo elemento se inserta según el orden de clasificación.
  • Si el control List Box no está clasificado, el nuevo elemento se añade al final de la lista.
El tipo de control (ordenado o no) se elige 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)

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 (color de fondo, imagen, diseño), utilice Funciones de gestión de cadenas gráficas.
WINDEVCódigo de Usuario (UMC)

Tabulaciones: Multi-elemento control List Box

Para gestionar las tabulaciones en un control List Box (alineación de columnas), utilice la constante TAB. Por ejemplo:
LIST_Customer.Add(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 .add 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 .add, 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 "CLIENTES" en 10 caracteres:
LIST_Customer.Add(Complete(LastName, 10) + TAB + Complete(FirstName, 10))

Varios

  • Para añadir elementos a una control Tabla, utilice <Table>.Add.
  • La función .add puede utilizarse en:
    • una columna de tipo "Combo Box" en una control Tabla.
    • a "Mesa" control Combo Box.
Componente: wd290obj.dll
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