VP Get values
VP Get values ( rangeObj : Object ) : Collection
| Parámetros | Tipo | Descripción | ||
|---|---|---|---|---|
| rangeObj | Object | -> | Objeto rango | |
| Result | Collection | <- | Colección de valores |
Descripción
El comando VP Get values recupera los valores del rangeObj designado.
En rangeObj, pase un rango cuyos valores desea recuperar. Si rangeObj incluye varios rangos, sólo se utiliza el primer rango.
La colección devuelta por VP Get values contiene una colección bidimensional:
- Cada elemento de la colección de primer nivel representa una línea y contiene una subcolección de valores
- Cada subcolección contiene los valores de las celdas de la línea. Los valores pueden ser enteros, reales, booleanos, texto, objeto o null. Si un valor es de tipo fecha u hora, se devuelve en un objeto con las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
| value | Fecha | Valor de la celda (excepto - time) |
| time | Real | Valor hora (en segundos) si el valor es del tipo de fecha js |
Las fechas o las horas son consideradas como un datetime y se completan de la siguiente manera:
- valor de tipo hora - la parte fecha se completa como 30 de diciembre de 1899
- valor de tipo date - la parte de la hora se completa como medianoche (00:00:00:000)
Ejemplo
Quiere obtener los valores de C4 a 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]