Si vous devez lire ou écrire des centaines de valeurs ou de formules différentes, vous pouvez le faire plus rapidement, plus facilement et en même temps en utilisant des collections. De nouvelles commandes sont disponibles pour cela : VP SET VALUES, VP Get values, VP SET FORMULAS, et VP Get formulas.
Lecture/écriture de valeurs
Pour définir des valeurs dans les cellules, créez une collection où chaque élément représente une ligne. Chaque ligne est une collection de valeurs de cellules à définir dans les colonnes. Voir l’exemple ci-dessous :
$values:=New collection
// First row
$values .push(New collection("ID" ; "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)
Pour récupérer les valeurs, il suffit de passer une plage qui inclut les cellules que vous souhaitez récupérer. VP Get values. La commande renvoie les valeurs dans les collections correspondantes.
$values:=VP Get values (VP Cells ("ViewProArea";1;1;8;2))
Voyez les commandes en action dans cette HDI :
HDI : Lire et écrire les valeurs des cellules
Formules de lecture/écriture
Le même concept s’applique également aux formules. Pour définir des formules dans les cellules de votre document 4D View Pro, vous devez créer une plage pour désigner la première cellule. Créez ensuite les collections souhaitées et passez-les en tant que paramètres à la commande 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)
Pour obtenir des formules, il suffit de passer une plage qui inclut les cellules contenant les formules à la commande VP Get formulas commande :
$formulas:=VP Get formulas (VP Cells ("ViewProArea";5;15;2;3))