VP Get values
VP Get values ( rangeObj : Object ) : Collection
| Parâmetro | Tipo | Descrição | ||
|---|---|---|---|---|
| rangeObj | Object | -> | Objeto intervalo | |
| Resultados | Collection | <- | Coleção de valores |
Descrição
O comando VP Get values recupera os valores do rangeObj.
Em rangeObj, passe um intervalo cujos valores você deseja recuperar. Se rangeObj incluir vários intervalos, somente o primeiro será usado.
A coleção retornada por VP Get values contém uma coleção bidimensional:
- Cada elemento da coleção de primeiro nível representa uma linha e contém uma subcoleção de valores.
- Cada subcoleção contém valores de células para a linha. Os valores podem ser Inteiro, Real, Booleano, Texto, Objeto ou Null. Se um valor for uma data ou hora, é retornado em um objeto com as propriedades abaixo:
| Propriedade | Tipo | Descrição |
|---|---|---|
| value | Date | Valor da célula (exceto - time) |
| time | Real | Valor hora (em segundos) se o valor for do tipo data js |
Datas ou horas são tratadas como um datetime e são completadas da forma abaixo:
- valor hora - a parte da data é preenchida como 30 de dezembro de 1899
- valor data - a porção hora é completa como meia noite (00:00:00:000)
Exemplo
Pretende obter 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]