Se è necessario leggere o scrivere centinaia di valori o formule diverse, è possibile farlo in modo più rapido, semplice e simultaneo utilizzando le collezioni. A tale scopo sono disponibili nuovi comandi: VP SET VALUES, VP Get values, VP SET FORMULAS, e VP Get formulas.
Leggere/scrivere valori
Per impostare i valori nelle celle, creare una collezione in cui ogni elemento rappresenta una riga. Ogni riga è una raccolta di valori di celle da impostare nelle colonne. Vedere l’esempio seguente:
$values:=New collection
// First row
$values .push(New collection("ID"; "Lunedì"; "Martedì"; "Mercoledì"; "Giovedì"; "Venerdì"; "Sabato"; "Domenica")
// 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)
Per recuperare i valori, è sufficiente passare un intervallo che includa le celle che si vuole VP Get values. Il comando restituisce i valori nelle raccolte corrispondenti.
$values:=VP Get values (VP Cells ("ViewProArea";1;1;8;2))
Vedete i comandi in azione in questo HDI:
HDI: lettura e scrittura dei valori delle celle
Leggere/scrivere formule
Lo stesso concetto si applica anche alle formule. Per impostare le formule nelle celle del documento 4D View Pro, è necessario creare un intervallo che designi la prima cella. Quindi creare le raccolte desiderate e passarle come parametri a 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)
Per ottenere le formule, basta passare un intervallo che includa le celle con le formule al comando VP Get formulas al comando:
$formulas:=VP Get formulas (VP Cells ("ViewProArea";5;15;2;3))