Saltar para o conteúdo principal
Versão: Próximo

VP SET VALUES

VP SET VALUES ( rangeObj : Object ; valuesCol : Collection )

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

Descrição

The VP SET VALUES command assigns a collection of values starting at the specified cell range.

In rangeObj, pass a range for the cell (created with VP Cell) whose value you want to specify. The cell defined in the rangeObj is used to determine the starting point.

  • If rangeObj is not a cell range, only the first cell of the range is used.
  • If rangeObj includes multiple ranges, only the first cell of the first range is used.

The valuesCol parameter is two-dimensional:

  • A coleção de primeiro nível contém subcoleções de valores. Cada subcolecção define uma linha. Passa uma coleção vazia para saltar uma linha.
  • Cada subcoleção define os valores das células para a linha. Os valores podem ser Integer, Real, Boolean, Text, Date, Null ou Object. Se o valor for um objeto, pode ter as seguintes propriedades:
PropriedadeTipoDescrição
valueInteger, Real, Boolean, Text, Date, NullValor da célula (exceto - time)
timeRealValor hora (em segundos)

Exemplo

$param:=New collection
$param.push(New collection(1;2;3;False)) //first row, 4 values
$param.push(New collection) //second row, untouched
$param.push(New collection(4;5;Null;"hello";"world")) // third row, 5 values
$param.push(New collection(6;7;8;9)) // fourth row, 4 values
$param.push(New collection(Null;New object("value";Current date;"time";42))) //fifth row, 1 value

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

Veja também

VP Get formulas
VP Get value
VP Get Values
VP SET FORMULAS
VP SET VALUE