VP ADD FORMULA NAME

4D v19

VP ADD FORMULA NAME


VP ADD FORMULA NAME ( vpNomeArea ; vpFormula ; nome {; opções} )

Parâmetro	Tipo	Descrição
vpNomeArea	Texto	Nome de objeto de área de formulário 4D View Pro
vpFormula	Texto	Fórmula 4D View Pro
nome	Texto	Nome para a fórmula
opções	Objeto	Opções para a fórmula nomeada

Descrição

O comando VP ADD FORMULA NAME cria ou modifica uma fórmula nomeada no documento aberto.

Nota: Fórmulas nomeadas criadas por este comando são salvas com o documento

Em vpAreaName, passe a propriedade nome objeto da área no formulário 4D. Se passar um nome inválido, um erro é retornado.

Passe a fórmula 4D View Pro que quiser para nomear em vpFormula. Para informações detalhadas sobre sintaxe de fórmulas, veja a seção Fórmulas 4D View Pro.

Passe o novo nome para a fórmula em nome. Se o nome já for usado dentro do mesmo escopo (alcance) a nova fórmula nomeada substitui a antiga. Note que pode usar o mesmo nome em diferentes escopos (ver abaixo).

Pode passar um objeto com propriedades adicionais para a fórmula nomeada em opções. As propriedades abaixo são compatíveis:

Propriedade

Tipo

Descrição

scope

Number

Escopo (alcance) para a fórmula. Pode passar uma folha de índice (contando a partir de 0) ou usar as constantes a seguir:

Constante	Valor	Comentário
vk current sheet	-1	Determina a folha atual de área 4D View Pro (padrão)
vk workbook	-2	Determina toda a folha de área 4D View Pro.

Nota: O escopo determina se o nome de fórmula é local a uma dada worksheet (scope=sheet index or vk current sheet), ou global para o workbook inteiro (scope=vk workbook).

baseRow

Número

(opcional) Ponto de partida personalizado (linha de células) para as referências relativas na fórmula. Se for omitido as referências relativas utilizarão (0;0) como ponto de partida. Quando se utilizar baseColumn è obrigatória.

baseColumn

Número

(opcional) Ponto de inicio personalizado (célula coluna) para as referências relativas na fórmula. Se for omitido, as referências relativas utilizarão (0;0) como ponto de partida. Quando se utilizar baseRow é obrigatória

comment

Text

Comentário associado à uma fórmula associada

Exemplo 1

VP ADD FORMULA NAME("ViewProArea";"SUM($A$1:$A$10)";"Total2")

Exemplo 2

Se quiser criar uma fórmula com nome que faça referência às dus células imediatamente superiores.

  //calcular a soma relativamente de A1 a A2

  //e basear a fórmula em baseRow=2 y baseColumn=0 (A3)

 VP ADD FORMULA NAME("vpArea";"SUM(A1:A2)";"sum2Above";New object("baseRow";2;"baseColumn";0))

  //então pode ser aplicado em qualquir lugar, aqui em D5

Ver também

VP Get formula by name
Referências de Célula
VP Get names