4D Doc Center : PV FIELD TO CELLS

4D View v14

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	Área 4D View
endereço	Inteiro	0 = Linha; 1 = Coluna
coluna	Inteiro longo	Número de coluna da célula de inicio
linha	Inteiro longo	Número de linha da célula de inicio
conversao	Inteiro	0 = Tipo texto; 1 = Tipo original
master	Inteiro	Número de tabela primária
numTabela	Inteiro	Número de tabela
numCampo	Inteiro	Número de campo

Descrição

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)