|
|
|
|
- Vinculación de datos simple
- Enlace de datos complejo
- Código de error (sintaxis 2 y 3)
- Control Tabla basado en un archivo de datos
- Limitaciones y casos especiales
Obtiene, modifica o restaura la vinculación de datos a una control o grupo de control s. ControlAlias no cambia el contenido del control, sólo cambia el enlace de datos. Para actualizar los controles con los valores del nuevo enlace de datos, utilice FileToScreen, TableDisplay, etc.
Advertencia
ControlAlias se mantiene por compatibilidad con el pasado: esta función no soporta la vinculación de datos. Se recomienda utilizar el DataBinding Property.
// Get the data binding of "EDT_CustomerName" ResDataBinding = ControlAlias(EDT_CustomerName)
Sintaxis
Obtención del enlace de datos de una control Ocultar los detalles
<Result> = ControlAlias(<Control used>)
<Result>: Cadena de caracteres Vinculación de los datos a una control determinada. El enlace tiene la siguiente sintaxis:
"<Base file>.<Base item>[:<Binding>[:<Binding>]]" donde <Enlace> corresponde a <Fichero relacionado>.<Clave>:<Artículo enlazado>[<Índice>] <Control used>: Nombre del control Nombre del control a manipular.
Modificación del enlace de datos de un control o un grupo de control s Ocultar los detalles
<Result> = ControlAlias(<Element used> , <New binding>)
<Result>: Integro - 0 si se ha realizado la modificación,
- un código de error (valor superior a 0).
<Element used>: Nombre de la control, nombre del grupo de la control o nombre de la ventana Nombre del control, grupo de control s, control Pestaña, control Tabla basado en un archivo de datos, columnas de la tabla o ventana a utilizar. Se modificarán los enlaces de datos de todos los controles del grupo, control Pestaña, control Tabla basados en un archivo de datos, columnas de la tabla o ventana. <New binding>: Cadena de caracteres Nuevo enlace de datos. Si este parámetro corresponde a una cadena vacía (""), la vinculación de datos se cancela. Este nuevo enlace puede corresponder a:- una unión de datos compleja:
"<Fichero base>.<Artículo base>[:<Enlace>[:<Enlace>]]" <Enlace> corresponde a: <Archivo relacionado>.<Clave>:<Artículo vinculado>[<Índice>] - un simple enlace de datos:
"<Nuevo archivo base> = <Fichero base actual>
Restablecer el enlace de datos inicial de un control o grupo de control s Ocultar los detalles
<Result> = ControlAlias(<Element used> , <caRestore>)
<Result>: Integro - 0 si se ha realizado la modificación,
- un código de error (valor superior a 0).
<Element used>: Nombre de la control, nombre del grupo de la control o nombre de la ventana Nombre del control, grupo de control s, control Pestaña, control Tabla basado en un archivo de datos, columnas de la tabla o ventana a utilizar. Se restaurarán los enlaces de datos de todos los controles del grupo, control Pestaña, control Tabla basados en un archivo de datos, columnas de la tabla o ventana. <caRestore>: Constante caRestore: Constante utilizada para restaurar el enlace de datos inicial de un control o grupo de control s. Observaciones Vinculación de datos simple Una vinculación simple corresponde a la siguiente sintaxis: "<Fichero base nuevo> = <Fichero base actual>". En este caso, sólo se modificarán los controles vinculados a los elementos del <Fichero base actual> y se vincularán al <Nuevo fichero base>. Por ejemplo, la Line del código: ControlAlias(WIN_Window, "CUSTOMER2001=CUSTOMER")
renombrará el archivo CUSTOMER como CUSTOMER2001 para los controles cuyo archivo base es "CUSTOMER". Los controles con un enlace a otro archivo de datos no se modificarán. Un enlace complejo corresponde a la siguiente sintaxis: "<Base file>.<Base item>[:<Binding>[:<Binding>]]" donde <Binding> corresponde a: <Related file>.<Key>:<Bound item>[<Index>] Esta description corresponde a: Código de error (sintaxis 2 y 3) Si se produce un error, ControlAlias muestra un mensaje y devuelve el código de error del mensaje: - 1: Error de sintaxis
- 2: Memoria insuficiente
- 3: Archivos HFSQL no inicializados
- 4: Archivo no encontrado
- 5: Artículo o archivo no encontrado
- 6: Valor de las claves que no se encuentran en el enlace
- 7: Archivo bloqueado o enlace no encontrado
- 10: Nombre de archivo demasiado largo
- 11: Nombre de posición demasiado largo
- 12: Demasiadas fijaciones descritas
- 13: Índice permitido sólo en el último elemento
- 14: Índice demasiado alto
- 15: Valor de índice no válido
- 16: ControlAlias no admite este tipo de control
- 17: La cuerda de la description es demasiado larga
- 18: Enlaces no permitidos en una tabla basada en un archivo de datos
Si se produce un error cuando se llama a ControlAlias en un control, la vinculación anterior no cambia. Si se asigna ControlAlias a un grupo de control s, el control en el que se produce el error y los siguientes control s no se modifican. Control Tabla basado en un archivo de datos - En una control Tabla basada en un archivo de datos, sólo se permiten los enlaces a los siguientes elementos:
- <Fichero base>
- <Fichero base>.<Artículo base>
- <Itemas básicos> deben corresponder a un elemento clave.
- El archivo es reemplazado para todas las columnas de tabla.
- <Itemas básicos> se aplican sólo a la tabla.
- ControlAlias sólo cambia el enlace del archivo interno a un control Tabla basado en un archivo de datos.
Limitaciones y casos especiales - ControlAlias no tiene efecto en los controles de tabla (y columnas) con fuente de datos en memoria, botones y controles ActiveX.
- Puede ocurrir que no se realice ninguna búsqueda en los archivos de datos de HyperFileSQL cuando se modifica un alias o una clave de búsqueda.. Una vez que los enlaces de datos han sido modificados por ControlAlias, se recomienda llamar:
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|