VP Get values

4D v19

VP Get values


VP Get values ( objRange ) -> Resultado

Parâmetro	Tipo	Descrição
objRange	Objeto	Objeto range
Resultado	Collection	Coleção de valores

Descrição

O comando VP Get values recupera os valores de objRango designado.

Em objRange, passe uma range cujos valores queira recuperar. Se objRango incluir múltiplas ranges, só se utiliza a primeira range.

a coleção devolvida por VP Get values contém uma coleção bidimensional:

Cada elemento da coleção de primeiro nivel representa uma fila e contém uma subcoleção de valores
Cada subcoleção contém valores de célula para a fila. Os valores podem ser Inteiro longo, Real, Booleano, Texto, Null. Se um valor for uma data ou hora, se devolve em um objeto com as propriedades abaixo:

Propriedade Tipo Descrição
value Data Valor na célula (exceto hora)
time Real Valor de tempo (em segundos) se o valor for de tipo de data js

As datas ou as horas são tratadas como data e hora e são completadas da maneira abaixo:

- valor de tempo: a parte da data se completa como 30 de dezembro de 1899
- valor de data: a parte de tempo se completa como meia noite (00:00:00:000)

Exemplo

Se quiser obter os 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]

Ver também

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