OBJECT SET LIST BY NAME
OBJECT SET LIST BY NAME ( {* ;} objeto {; listType}; lista )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| * | Operador | → | Si se especifica, objeto es un nombre de objeto (cadena) Si se omite, objeto es un campo o una variable |
| objeto | any | → | Nombre de objeto (si se especifica *), o Campo o variable (si se omite *) |
| listType | Integer | → | Tipo de lista: Lista de selección, Lista obligatoria o Lista de excluidos |
| lista | Text | → | Nombre de la lista a utilizar (definida en el entorno Diseño) |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
El comando OBJECT SET LIST BY NAME define, reemplaza o disocia la lista asociada al objeto o al grupo de objetos designado por objeto. La lista cuyo nombre se pasa en el parámetro lista debe haber sido creada en el editor de listas en el entorno Diseño*.*
Este comando puede aplicarse a un formulario de entrada o diálogo, a campos y variables editables cuyos valores pueden introducirse como texto.
Si pasa el parámetro opcional *, indica que el parámetro objeto es un nombre de objeto (una cadena). Si omite el parámetro *, indica que el parámetro objeto es un campo o una variable. En este caso, usted especifica una referencia de un campo o de una variable (campo o variable de tipo objeto únicamente) en lugar de una cadena.
Nota: este comando no puede utilizarse con campos ubicados en un formulario listado de un subformulario.
El comando OBJECT SET LIST BY NAME le permite definir o remplazar todos los tipos de listas asociadas a los objetos designados por los parámetros objeto y *: listas de selección, lista de valores obligatorios y listas de valores excluidos. Para ello, en el parámetro tipoLista pase una de las siguientes constantes, que se encuentra en el tema "Propiedades de los objetos":
| Constante | Tipo | Valor | Comentario |
|---|---|---|---|
| Choice list | Entero largo | 0 | Lista simple de selección de valores (opción "Lista" en la Lista de Propiedades) (por defecto) |
| Excluded list | Entero largo | 2 | Lista de valores no aceptados para la entrada (Opción "Exclusiones" en la lista de propiedades) |
| Required list | Entero largo | 1 | Lista sólo los valores aceptados para la entrada (Opción "Obligatoria" en la Lista de Propiedades) |
Si omite este parámetro, el valor 0 (lista de selección) se utiliza por defecto.
En el proceso actual, para desvincular una lista que se asoció al objeto, pase una cadena vacía ("") en el parámetro lista para el tipo de lista concerniente.
La lista de valores existente se sustituye en función de cómo se asocie la lista al objeto formulario:
- utilizando una lista de selección: se sustituye la propia lista.
- utilizando un array: la lista se copia en elementos de array.
- utilizando un objeto (no soportado en bases de datos binarias): la lista se copia como elementos de la colección en la propiedad values del objeto.
Ejemplo 1
El siguiente ejemplo define una lista asociada a un campo Envío. Si el envío debe realizarse en la noche, entonces la lista muestra las empresas que realizan envíos en la noche. De lo contrario, se asignan las empresas de envíos estándar:
If([Envios]Overnight)
OBJECT SET LIST BY NAME([Envios]Empresa;"Envios de noche")
Else
OBJECT SET LIST BY NAME([Envios]Empresa;"Envios estándar")
End if
Ejemplo 2
Asocia la lista "color_choice" como una lista desplegable simple llamada "DoorColor":
OBJECT SET LIST BY NAME(*;"DoorColor";Choice list;"color_choice")
// en este caso, el tercer parámetro (constante) puede omitirse
Ejemplo 3
Usted desea asociar la lista "color_choice" al combo box "WallColor". Como este combo box es editable, usted desea que no sea posible usar ciertos colores como el "negro", "morado", etc. Estos colores se colocan en la lista "excl_colors":
OBJECT SET LIST BY NAME(*;"WallColor";Choice list;"color_choice")
OBJECT SET LIST BY NAME(*;"WallColor";Excluded list;"excl_colors")
Ejemplo 4
Usted quiere eliminar la lista de asociaciones:
// eliminación de una lista de selección
OBJECT SET LIST BY NAME(*;"DoorColor";Choice list;"")
// eliminación de una lista de valores que que no son permitidos
OBJECT SET LIST BY NAME(*;"WallColor";Excluded list;"")