4D Doc Center : PV FIELD TO CELLS

4D View v14

PV FIELD TO CELLS


PV FIELD TO CELLS ( area ; direccion ; columna ; linea ; conversion ; master ; numTabla ; numCampo )

Parámetro	Tipo	Descripción
area	Entero largo	Área 4D View
direccion	Entero	0 = Línea; 1 = Columna
columna	Entero largo	Número de columna de la celda de inicio
linea	Entero largo	Número de línea de la celda de inicio
conversion	Entero	0 = Tipo texto; 1 = Tipo original
master	Entero	Número de tabla primaria
numTabla	Entero	Número de tabla
numCampo	Entero	Número de campo

Descripción

El comando PV FIELD TO CELLS inserta en area los valores de campo correspondientes a la selección actual de la tabla master. La inserción se efectúa a partir de la celda definida por las coordenadas linea y columna, en el sentido definido por direccion.

Nota: el uso del parámetro direccion es diferente del parámetro dirección en los comandos PV GOTO NEXT CELL y PV GET NEXT FREE CELL, donde la direccion puede ser en cualquier sentido. Para PV FIELD TO CELLS, la direccion es hacia la derecha (0=linea), o hacia la parte inferior (1=columna).

El quinto parámetro, conversion, permite volver a escribir el contenido de la celda como texto. El tipo de valor fuente debe ser compatible con esta operación: si usted solicita un cambio de tipo un BLOB o de una imagen a texto, conversion se ignorará.

El comando se puede aplicar a una tabla relacionada a una tabla primaria por una relación. Este último debe ser de tipo automático (tipo) y pasar de la tabla definida por master a la tabla definida por tabla que contiene el campo a mostrar. El ejemplo tradicional de facturas y de líneas de facturas, permite recuperar el contenido de un campo de la tabla de líneas, y también de la tabla de facturas relativa a una selección de la tabla de líneas de facturas (tabla principal).

A diferencia de los comandos de tipo PV SET CELL FIELD, que mantienen una relación dinámica con la base de datos, las modificaciones de valores efectuadas en el área 4D View, después de haber sido recuperados utilizando el comando PV FIELD TO CELLS no se ejecutan en el contenido de los registros.

Ejemplo

En el ejemplo del comando PV CELLS TO ARRAY, actualizamos la tabla de contactos una vez se entró en un área 4D View incluida en un formulario de entrada del cliente. Aquí, vamos a actualizar el área incluida durante el evento de formulario On Load, en otras palabras, durante la carga del formulario de entrada que se está modificando.

Una relación automática de la tabla primaria de contactos a la tabla de título profesional (Presidente, Secretario, Desarrollador) permite recuperar, en el campo ad hoc de este último, la etiqueta del título de cada contacto a partir de su código de título guardado como un entero (campo de inicio de la relación). Vamos a mostrar el nombre del contacto y el título en dos columnas.

 C_INTEGER($Primaria) `Número de la tabla primaria

 C_INTEGER($Tabla) `Número de tabla

 C_INTEGER($Campo) `Número de campo

 C_LONGINT($Columna;$Linea) `Coordenadas de la celda de inicio

 

 $Primaria:=Table(->[Contactos]) `Número de la tabla primaria: contactos (para las dos columnas)

 RELATE MANY([Clientes]code) `Recuperación de la selección de contactos correspondientes

 PV GET CURRENT CELL(Area;$Columna;$Linea)

 

  `Actualización del área 4D View para los nombres

 $Tabla:=Table(->[Contactos]) `Número de la tabla de contactos

 $Campo:=Field(->[Contactos]ContactName) `Número de campo cuyo contenido se recuperará

  `La conversión no es necesaria, recuperamos de la alfanumérica

 PV FIELD TO CELLS(Area;1;$Columna;$Linea;0;$Primaria;$Tabla;$Campo)

 

  `Actualización del área 4D View para los títulos

 $Tabla:=Table(->[Titulos]) `Número de la tabla de los títulos tipos (relacionados)

 $Campo:=Field(->[Titulos]Label) `Número de campo cuyo contenido será recuperado

 PV FIELD TO CELLS(Area;1;$Columna+1;$Linea;0;$Primaria;$Tabla;$Campo)