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 de controles
  • 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
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
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.
Ejemplo
// 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.

Enlace de datos complejo

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:
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: 27/05/2022

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