4D Doc Center : PV ADD DYNAMIC ARRAYS

4D View v14

PV ADD DYNAMIC ARRAYS


PV ADD DYNAMIC ARRAYS ( area ; array )

Parâmetro	Tipo	Descrição
area	Inteiro longo	Área 4D View
array	Array cadeia	Array que contém os nomes de array

Descrição

O comando PV ADD DYNAMIC ARRAYS agrega em area um bloqueio de linhas correspondentes aos valores dos arrays cujos nomes se passam via o parâmetro array, a partir da célula A1.

Todos os arrays devem conter o mesmo número de elementos e sempre se apresentam verticalmente (em colunas). O primeiro array se mostra na coluna A, os outros nas colunas localizadas a direita.

Nota: Se uma área de campos dinâmicos já existe na área 4D View com o comando PV ADD DYNAMIC FIELDS, se exclui e se substitui pelos arrays dinâmicos.

PV ADD DYNAMIC ARRAYS mantém um link dinâmico com os arrays associados a parte dinâmica da área. Como resultado, as modificações dos valores atribuídos em uma área 4D View serão vistas refletidas dentro de cada array e vice-versa. Suprimir ou adicionar elementos no array 4D também será vista refletida na área.

Não é possível estabelecer várias partes dinâmicas na mesma área 4D View.

Notas:

Os array(s) e a área de 4D View devem ser definidos no mesmo processo.
A atualização dinâmica de dados não está disponível entre os registros que aparecem nos formulários de 4D e as janelas externas 4D View. Para refletir em uma janela 4D View uma modificação realizada no registro de 4D, é necessário voltar a desenhar a janela com comando o PV REDRAW (as modificações executadas através de comandos 4D se refletem automaticamente nas áreas 4D View).

Exemplo

O seguinte exemplo recupera os nomes dos contatos relacionados com o registro atual da tabela clientes em um array, depois, mostra o conteúdo em uma área 4D View incluída no formulário de entrada do cliente que esta sendo modificado.

As modificações realizadas pelo usuário se reflete diretamente nos arrays 4D, que vamos lidar, por exemplo, mediante a atualização da seleção dos contatos gravados.

 ARRAY TEXT(NamesArray;0) `Array de sobrenomes de contatos

 ARRAY TEXT(FirstnamesArray;0) `Array de nomes de contatos

 ARRAY STRING(31;$ArrayArrays;2) `Arrays de nomes de arrays

 

 $ArrayArrays{1}:="NamesArray" `Primeira coluna dinâmica

 $ArrayArrays{2}:="FirstnamesArray" `Segunda coluna dinâmica

 

 RELATE MANY([Clientes]Code) `Recuperação dos contatos relacionados

 SELECTION TO ARRAY([Contatos]ContactName;NamesArray;[Contatos]ContactFirstname;FirstnamesArray)

 

 PV ADD DYNAMIC ARRAYS(Area;$ArrayArrays)