VP Get values
VP Get values ( rangeObj : Object ) : Collection
Paramètres | Type | Description | ||
---|---|---|---|---|
rangeObj | Object | -> | Objet plage | |
Résultat | Collection | <- | Collection de valeurs |
Description
The VP Get values
command retrieves the values from the designated rangeObj.
In rangeObj, pass a range whose values you want to retrieve. If rangeObj includes multiple ranges, only the first range is used.
The collection returned by VP Get values
contains a two-dimensional collection:
- Chaque élément de la collection de premier niveau représente une ligne et contient une sous-collection de valeurs
- Chaque sous-collection contient des valeurs des cellule de la ligne. Values can be Integer, Real, Boolean, Text, Object, or Null. Si une valeur est de type date ou heure, elle est retournée en un objet dont les propriétés sont les suivantes :
Propriété | Type | Description |
---|---|---|
value | Date | Valeur dans la cellule (sauf heure) |
time | Real | Valeur heure (en secondes) si la valeur est du type js |
Les dates ou les heures sont considérées comme un datetime et sont complétées comme suit :
- valeur de type heure - la partie date est complétée comme étant le 30 décembre 1899
- valeur de type date - la partie heure est complétée comme étant minuit (00:00:00:000)
Exemple
Vous souhaitez lire les valeurs allant de C4 à G6 :
$result:=VP Get values(VP Cells("ViewProArea";2;3;5;3))
// $result[0]=[4,5,null,hello,world]
// $result[1]=[6,7,8,9,null]
// $result[2]=[null,{time:42,value:2019-05-29T00:00:00.000Z},null,null,null]