VP SET VALUE

4D v19

VP SET VALUE


VP SET VALUE ( objRange ; objValor )

Parâmetro	Tipo	Descrição
objRange	Objeto	Objeto range
objValor	Objeto	Valores de célula e opções de formato

Descrição

O comando VP SET VALUE atribui um valor específico a uma range de célula designada.

O comando lhe permite utilizar um código genérico para establecer e formatar os tipos de valores em objRange, enquanto que outros comandos, como VP SET TEXT VALUE e VP SET NUM VALUE, reduzem os valores a tipos específicos.

Em objRange, passe uma range das células (criadas por exemplo com VP Cell ou VP Column) cujo valor quiser especificar. Se objRange inclui várias células, o valor especificado se repetirá em cada célula.

O parâmetro objValor é um objeto que inclui propriedades para o valor e o formato para atribuir a objRange. Pode incluir as propriedades abaixo:

Propriedade	Tipo	Descrição
value	Inteiro longo, Real, Booleano, Texto, Data, Null	Valor a atribuir a objRange (exceto- hora). Passe null para apagar o conteúdo da célula.
time	Real	Valor de tempo (em segundos) para atribuir a objRange
format	Texto	Padrão para a propriedade valor/tempo. Para obter informação sobre padrões e caracteres de formato, consulte a seção 4D View Pro Cell Format.

Exemplo

  //Definir o valor da célula como False

 VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";False))

 

  //Definir o valor da célula como 2

 VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";2))

 

  //Definir o valor da célula como $125,571.35

 VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";125571.35;"format";"_($* #,##0.00_)"))

 

  //Definir o valor da célula como Hello World!

 VP SET VALUE(VP Cell("ViewProArea";3;2);New object("value";"Hello World!"))

 

  //Definir o valor da célula como data atual

 VP SET VALUE(VP Cell("ViewProArea";4;2);New object("value";Current date))

 

  //Definir o valor da célula como hora atual

 VP SET VALUE(VP Cell("ViewProArea";5;2);New object("time";Current hour))

 

  //Definir o valor da célula como data e hora específicas

 VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";!2024-12-18!);"time";?14:30:10?;"format";vk pattern full date time))

 

  //Apagar o conteúdo da célula

 VP SET VALUE(VP Cell("ViewProArea";3;9);New object("value";Null))

Ver também

4D View Pro Cell Format
VP Get value
VP SET BOOLEAN VALUE
VP SET DATE TIME VALUE
VP SET DATE VALUE
VP SET FIELD
VP SET FORMULA
VP SET NUM VALUE
VP SET TEXT VALUE
VP SET TIME VALUE
VP SET VALUES