VP SET VALUE

4D v18

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

VP SET VALUES