4D View v14

PV FIELD TO CELLS

Página Inicial

 
4D View v14
PV FIELD TO CELLS

PV FIELD TO CELLS 


 

PV FIELD TO CELLS ( area ; endereço ; coluna ; linha ; conversao ; master ; numTabela ; numCampo ) 
Parâmetro Tipo   Descrição
area  Inteiro longo in Área 4D View
endereço  Inteiro in 0 = Linha; 1 = Coluna
coluna  Inteiro longo in Número de coluna da célula de inicio
linha  Inteiro longo in Número de linha da célula de inicio
conversao  Inteiro in 0 = Tipo texto; 1 = Tipo original
master  Inteiro in Número de tabela primária
numTabela  Inteiro in Número de tabela
numCampo  Inteiro in Número de campo

O comando PV FIELD TO CELLS insere em area os valores de campo correspondentes a seleção atual da tabela master. A inserção se realiza a partir da célula definida pelas coordenadas linha e coluna, no sentido definido por endereço.

Nota: O uso do parâmetro endereço é diferente do parâmetro endereço nos comandos PV GOTO NEXT CELL e PV GET NEXT FREE CELL, onde o endereço pode ser em qualquer sentido. Para PV FIELD TO CELLS, o endereço é para a direita (0=linha), ou para a parte inferior (1=coluna).

O quinto parâmetro, conversao, permite voltar a escrever o conteúdo da célula como texto. O tipo de valor fonte deve ser compatível com esta operação: se você solicita uma mudança de tipo um BLOB ou de uma imagem a texto, conversao será ignorada.

O comando pode ser aplicada a uma tabela relacionada a uma tabela primária por uma relação. Este último deve ser de tipo automático (tipo) e passar da tabela definida por master a tabela definida por tabela que contém o campo a mostrar. O exemplo tradicional de faturas e de linhas de faturas, permite recuperar o conteúdo de um campo da tabela de linhas, e também da tabela de faturas relativa a uma seleção da tabela de linhas de faturas (tabela principal).

A diferença dos comandos de tipo PV SET CELL FIELD, que mantém uma relação dinâmica com o banco de dados, as modificações de valores realizadas na área 4D View, depois de ter sido recuperados utilizando o comando PV FIELD TO CELLS não se executam no conteúdo dos registros.

Exemplo  

No exemplo do comando PV CELLS TO ARRAY, atualizamos a tabela de contatos uma vez se entrou em uma área 4D View incluída em um formulário de entrada do cliente. Aqui, vamos a atualizar a área incluída durante o evento de formulário On Load, em outras palavras, durante a carga do formulário de entrada que se está modificando.

Uma relação automática da tabela primária de contatos a tabela de título profissional (Presidente, Secretário, Programador) permite recuperar, no campo ad hoc deste último, a etiqueta do título de cada contato a partir de seu código de título guardado como um inteiro (campo de início da relação). Vamos mostrar o nome do contato e o título em dois colunas.

 C_INTEGER($Primaria`Número da tabela primária
 C_INTEGER($Tabela`Número de tabela
 C_INTEGER($Campo`Número de campo
 C_LONGINT($Coluna;$Linha`Coordenadas da célula de início
 
 $Primaria:=Table(->[Contatos]) `Número da tabela primária: contatos (para as duas colunas)
 RELATE MANY([Clientes]code) `Recuperação da seleção de contatos correspondentes
 PV GET CURRENT CELL(Area;$Coluna;$Linha)
 
  `Atualização da área 4D View para os nomes
 $Tabela:=Table(->[Contatos]) `Número da tabela de contatos
 $Campo:=Field(->[Contatos]ContactName) `Número de campo cujo conteúdo se recuperará
  `A conversão não é necessária, recuperamos da alfanumérica
 PV FIELD TO CELLS(Area;1;$Coluna;$Linha;0;$Primaria;$Tabela;$Campo)
 
  `Atualização da área 4D View para os títulos
 $Tabela:=Table(->[Títulos]`Número da tabela dos títulos tipos (relacionados)
 $Campo:=Field(->[Títulos]Label`Número de campo cujo conteúdo será recuperado
 PV FIELD TO CELLS(Area;1;$Coluna+1;$Linha;0;$Primária;$Tabela;$Campo)

 
PROPRIEDADES 

Produto: 4D View
Tema: PV Valor célula
Número 15908

 
HISTÓRIA 

Criado por: 4D View 6.8

 
VER TAMBÉM 

PV ARRAY TO CELLS
PV FIELDS LIST TO CELLS
PV SET CELL FIELD

 
ARTICLE USAGE

4D View Linguagem ( 4D View v11.4)
4D View Linguagem ( 4D View v12)
4D View Linguagem ( 4D v13)
4D View Linguagem ( 4D View v14 R2)
4D View Linguagem ( 4D View v14)
4D View Linguagem ( 4D View v14 R3)
4D View Linguagem ( 4D View v14 R4)