VP SET VALUES

4D v19

VP SET VALUES


VP SET VALUES ( objRange ; colValores )

Parâmetro	Tipo	Descrição
objRange	Objeto	Objeto range de células
colValores	Collection	Coleção de valores

Descrição

O comando VP SET VALUESatribui uma coleção de valores a partir da range de células especificada.

Em objRange, passe uma range de célula (criado com VP Cell) cujo valor quiser especificar. A célula definida em objRange se utilizar para determinar o ponto de inicio.

Notas:

Se objRange não for uma range de células, só se utiliza a primeira célula da range.
Se objRange incluir múltiplas ranges, só se utiliza a primeira célula de primeira range.

O parâmetro colValores é bidimensional:

a coleção de primeiro nivel contém subcoleções de valores. Cada subcoleção define uma fila. Passa uma coleção vazia para saltar uma fila.
Cada subcoleção define valores de célula para a fila. Os valores podem ser Inteiro longo, Real, Booleano, Texto, Data, Null ou Objeto. Se o valor for um objeto, pode ter as propriedades abaixo:

Propriedade Tipo Descrição
value Inteiro longo, Real, Booleano, Texto, Data, Null Valor na célula (exceto tempo)
time Real Valor de tempo (em segundos)

Exemplo

O código abaiox:

 $param:=New collection

 $param.push(New collection(1;2;3;False)) //primeira linha, 4 valores

 $param.push(New collection) //segunda linha, se deixa igual

 $param.push(New collection(4;5;Null;"hello";"world")) // terceira linha, 5 valores

 $param.push(New collection(6;7;8;9)) // quarta linha, 4 valores

 $param.push(New collection(Null;New object("value";Current date;"time";42))) //quinta linha, 1 valor

 VP SET VALUES(VP Cell("ViewProArea";2;1);$param)

... produz o resultado abaixo:

Ver também

VP Get formulas
VP Get value
VP Get values
VP SET FORMULAS
VP SET VALUE