Se precisar de ler ou escrever centenas de valores ou fórmulas diferentes, pode fazê-lo mais rapidamente, mais facilmente, e ao mesmo tempo utilizando colecções. Estão disponíveis novos comandos para o efeito: VP SET VALUES, VP Get values, VP SET FORMULASe VP Get formulas.
Valores de leitura/escrita
Para definir valores em células, criar uma colecção onde cada elemento representa uma fila. Cada linha é uma colecção de valores de células a serem definidos nas colunas. Ver o exemplo abaixo:
$values:=New collection
// First row
$values .push(New collection("ID"; "Monday"; "Monday"; "Tuesday"; "Wednesday"; "Thursday"; "Friday"; "Saturday"; "Sunday"))
// Second row
$values .push(New collection(1;1778;5656;22269;2964;20890;32189;26212))
// Write all values in the document
VP SET VALUES (VP Cell ("ViewProArea";1;1);$values)
Para recuperar os valores, basta passar um intervalo que inclua as células que deseja VP Get values. O comando devolve os valores das colecções correspondentes.
$values:=VP Get values (VP Cells ("ViewProArea";1;1;8;2))
Ver os comandos em acção neste IDH:
HDI: Ler e Escrever Valores de Células
Fórmulas de leitura/escrita
O mesmo conceito também se aplica às fórmulas. Para definir as fórmulas nas células do seu documento 4D View Pro, é necessário criar um intervalo para designar a primeira célula. Depois crie as colecções desejadas e passe-as como parâmetros para VP SET FORMULAS:
$formulas:=New collection
// First row
$formulas .push(New collection("myMethod(I3)"; "MAX(A1,B2,C3,D4,E5)"))
// Second row
$formulas .push(New collection("SUM(C5:I5)"; "AVERAGE(C5:I5)"))
// Set the cells with the formulas
VP SET FORMULAS (VP Cell ("ViewProArea";5;15);$formulas)
Para obter as fórmulas, basta passar um intervalo que inclua as células com as fórmulas para VP Get formulas comando:
$formulas:=VP Get formulas (VP Cells ("ViewProArea";5;15;2;3))