OBJECT SET DATA SOURCE
OBJECT SET DATA SOURCE ( {* ;} objeto ; fuenteDatos )
| 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 *) |
| fuenteDatos | Pointer | → | Puntero a la nueva fuente de datos del objeto |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
El comando OBJECT SET DATA SOURCE modifica la fuente de datos de los objetos designados por los parámetros objeto y * .
Si pasa el parámetro opcional * indica que el parámetro objeto es un nombre de objeto (cadena). Si no pasa este parámetro, indica que el parámetro objeto es un campo o una variable. En este caso, se pasa una referencia de campo o variable en lugar de una cadena (campo o variable objeto únicamente).
La fuente de datos es el campo o la variable cuyo valor es representado por el objeto cuando se ejecuta el formulario. En modo Diseño, la fuente de datos se define en la lista de propiedades, por lo general a través de las líneas Fuente y Campo fuente (campos) o Nombre de variable (variables):
A excepción de los list box (ver más adelante), todas las fuentes de datos del formulario pueden ser modificadas por este comando. Es responsabilidad del desarrollador asegurar la consistencia de los cambios realizados.
En el caso de los list box, se deben tener en cuenta los siguientes puntos:
- Los cambios de fuentes de datos deben tener en cuenta el tipo de list box: por ejemplo, no es posible utilizar un campo como fuente de datos de una columna de en un list box de tipo array.
- Para los list box de tipo selección, no es posible modificar o leer la fuente de datos del objeto list box en sí: en este caso, se trata de una referencia interna y no de una fuente de datos.
- Este comando se utiliza en el contexto de los list box de tipo array. Para los list box de tipo selección, puede en vez utilizar el comando [LISTBOX SET COLUMN FORMULA
Si este comando se aplica a una fuente de datos que no se puede editar, no hace nada.
Ejemplo
Cambio de la fuente de datos para un área de entrada:
var $ptrField : Pointer
$ptrField:=Field(3;2)
OBJECT SET DATA SOURCE(*;"Input";$ptrField)