Saltar para o conteúdo principal
Versão: 20 R6 BETA

VP Get values

VP Get values ( rangeObj : Object ) : Collection

ParâmetroTipoDescrição
rangeObjObject->Objeto intervalo
ResultadosCollection<-Coleção de valores

Descrição

The VP Get values command retrieves the values from the designated 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:
PropriedadeTipoDescrição
valueDateValor da célula (exceto - time)
timeRealValor 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]

Veja também

VP Get formulas
VP Get value
VP SET FORMULAS
VP SET VALUES