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
  • Añadir un elemento al navegador
  • 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
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 ListInsert.
  • La función ListAdd 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.
WEBDEV - Código Navegador Atención: El elemento sólo se añadirá a la página mostrada en el navegador.. Para más detalles, véase Observaciones.
Ejemplo
// Add the customer named "Moore" into "LIST_CustomerList"
ListAdd(LIST_CustomerList, "Moore")
WINDEVWEBDEV - Código ServidorWEBDEV - Código NavegadorReportes y ConsultasUniversal Windows 10 AppAndroidJavaCódigo de Usuario (UMC)Ajax
// Add the customers named "Clark" and "Smith" into "LIST_CustomerList"
ListAdd(LIST_CustomerList, "Clark" + CR + "Smith")
WINDEVReportes y ConsultasJavaCó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"
ListAdd(LSV_Diving, "Nice coral", "C:\MyImages\CoralReef.JPG")
WINDEVWEBDEV - Código ServidorWEBDEV - Código NavegadorReportes y ConsultasUniversal Windows 10 AppAndroidJavaCódigo de Usuario (UMC)Ajax
// The "COMBO_Title" Combo Box displays personal titles:
// "Mister", "Madam" and "Miss".
// An integer representing a gender will be returned to the language.
ListeAdd(COMBO_Title, "Mister" + gStoredValue("1"))
Sintaxis
<Result> = ListAdd(<Control to use> [, <Element> [, <Path of image to display>]])
<Result>: booleano
  • True si se agregó el elemento,
  • False en caso contrario.
WEBDEV - Código NavegadorPHP La función ListAdd no devuelve ningún resultado.
<Control to use>: Nombre del control
Nombre del control a manipular:
  • control List Box se rellenó de forma programada,
  • control ListView se rellenó de forma programada,
  • control Combo Box se rellenó de forma programada.
Si este parámetro corresponde a una cadena vacía (""), el elemento se añade a la control List Box (o Combo Box) a la que pertenece la Event actual.
WEBDEV - Código Navegador Se debe especificar el nombre del Cuadro de la Lista (o Combo Box) control a utilizar.
<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.
WEBDEV - Código ServidorWEBDEV - Código NavegadorAndroidJavaPHP Se admiten los caracteres de retorno de carro (CR), mientras que no se admiten las tabulaciones (TAB).
WEBDEV - Código Servidor Para añadir varios espacios consecutivos, se deben utilizar caracteres de espacio no separables.: Charact(160).
<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).
WEBDEV - Código ServidorWEBDEV - Código NavegadorUniversal Windows 10 AppAndroidiPhone/iPadPHP 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).
WINDEVWEBDEV - Código ServidorReportes y ConsultasAndroidiPhone/iPadJavaCódigo de Usuario (UMC)Ajax

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.
WINDEVWEBDEV - Código ServidorWEBDEV - Código NavegadorReportes y ConsultasUniversal Windows 10 AppAndroidiPhone/iPadJavaCódigo de Usuario (UMC)Ajax

Equivalencia

Las dos sintaxis siguientes son equivalentes:
ListAdd(<Control name> [<Element>])
y
<Control name>[Index] = <Element>
WINDEVWEBDEV - Código ServidorWEBDEV - Código NavegadorReportes y ConsultasUniversal Windows 10 AppAndroidiPhone/iPadJavaCódigo de Usuario (UMC)Ajax

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 ListAdd en lugar de ListInsert para añadir un elemento a un control List Box ordenado.
WEBDEV - Código Navegador El elemento se agrega al final de control, sin importar si el control List Box está clasificado o no.
WINDEVReportes y ConsultasCó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.
WINDEVReportes y ConsultasCó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:
ListAdd(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 ListAdd 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 ListAdd, se aconseja definir el ancho de las columnas con Complete. Por ejemplo, para fijar el ancho de las columnas que se encuentran en "CLIENTES" en 10 caracteres:
ListAdd(LIST_Customer, Complete(LastName, 10) + TAB + Complete(FirstName, 10))
WEBDEV - Código Navegador

Añadir un elemento al navegador

Al añadir un elemento en el código del navegador, este elemento se añade a la página que se muestra sólo en el navegador.. Para agregar este elemento al servidor, la función ListAdd debe ejecutarse en el servidor.
Llamar a ListAdd en el código del navegador es útil cuando se utiliza Tecnología AJAX, en modo "AJAX programado" (mediante AJAXExecute o AJAXExecuteAsynchronous).
Recordatorio: En el modo "AJAX automático e inmediato", solo se debe cambiar el proceso del servidor que contiene la función ListAdd al modo AJAX automático. ¡Eso es! No se requiere ninguna programación adicional. Para obtener más información, consulte AJAX.

Varios

  • Para añadir elementos a una control Tabla, utilice TableAdd.
  • La función ListAdd 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 9
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 08/06/2022

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